home *** CD-ROM | disk | FTP | other *** search
MacBinary | 1992-11-18 | 137.9 KB | [ONLN/HLX2] |
open in:
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: MacBinary
(archive/macBinary).
Confidence | Program | Detection | Match Type | Support
|
---|
10%
| dexvert
| MacBinary (archive/macBinary)
| fallback
| Supported |
100%
| file
| MacBinary II, inited, Wed Nov 18 07:18:34 1992, modified Wed Nov 18 10:52:42 1992, creator 'HLX2', type 'ONLN', 136017 bytes "TN-Interapplication Comm." , at 0x213d1 4895 bytes resource
| default (weak)
| |
99%
| file
| data
| default
| |
100%
| TrID
| MacBinary 2
| default (weak)
| |
100%
| lsar
| MacBinary
| default
|
|
id metadata |
---|
key | value |
---|
macFileType | [ONLN] |
macFileCreator | [HLX2] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 19 54 4e 2d 49 6e 74 | 65 72 61 70 70 6c 69 63 |..TN-Int|erapplic|
|00000010| 61 74 69 6f 6e 20 43 6f | 6d 6d 2e 00 00 00 00 00 |ation Co|mm......|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 02 13 51 00 | 00 13 1f a7 2f e5 1a a7 |......Q.|..../...|
|00000060| 30 17 4a 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |0.J.....|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 7c ce 00 00 |........|....|...|
|00000080| ca 0d 41 70 70 6c 65 20 | 45 76 65 6e 74 20 4d 61 |..Apple |Event Ma|
|00000090| 6e 61 67 65 72 20 51 26 | 41 73 0d 49 6e 74 65 72 |nager Q&|As.Inter|
|000000a0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 43 6f 6d 6d |applicat|ion Comm|
|000000b0| 75 6e 69 63 61 74 69 6f | 6e 09 4d 2e 49 43 2e 41 |unicatio|n.M.IC.A|
|000000c0| 45 4d 67 72 2e 51 26 41 | 73 0d 52 65 76 69 73 65 |EMgr.Q&A|s.Revise|
|000000d0| 64 20 62 79 3a 09 44 65 | 76 65 6c 6f 70 65 72 20 |d by:.De|veloper |
|000000e0| 53 75 70 70 6f 72 74 20 | 43 65 6e 74 65 72 09 4f |Support |Center.O|
|000000f0| 63 74 6f 62 65 72 20 31 | 39 39 32 0d 57 72 69 74 |ctober 1|992.Writ|
|00000100| 74 65 6e 20 62 79 3a 09 | 44 65 76 65 6c 6f 70 65 |ten by:.|Develope|
|00000110| 72 20 53 75 70 70 6f 72 | 74 20 43 65 6e 74 65 72 |r Suppor|t Center|
|00000120| 09 4f 63 74 6f 62 65 72 | 20 31 39 39 30 0d 54 68 |.October| 1990.Th|
|00000130| 69 73 20 54 65 63 68 6e | 69 63 61 6c 20 4e 6f 74 |is Techn|ical Not|
|00000140| 65 20 63 6f 6e 74 61 69 | 6e 73 20 61 20 63 6f 6c |e contai|ns a col|
|00000150| 6c 65 63 74 69 6f 6e 20 | 6f 66 20 51 26 41 73 20 |lection |of Q&As |
|00000160| 72 65 6c 61 74 69 6e 67 | 20 74 6f 20 61 20 73 70 |relating| to a sp|
|00000170| 65 63 69 66 69 63 20 74 | 6f 70 69 63 d1 71 75 65 |ecific t|opic.que|
|00000180| 73 74 69 6f 6e 73 20 79 | 6f 75 d5 76 65 20 73 65 |stions y|ou.ve se|
|00000190| 6e 74 20 74 68 65 20 44 | 65 76 65 6c 6f 70 65 72 |nt the D|eveloper|
|000001a0| 20 53 75 70 70 6f 72 74 | 20 43 65 6e 74 65 72 20 | Support| Center |
|000001b0| 28 44 53 43 29 20 61 6c | 6f 6e 67 20 77 69 74 68 |(DSC) al|ong with|
|000001c0| 20 61 6e 73 77 65 72 73 | 20 66 72 6f 6d 20 74 68 | answers| from th|
|000001d0| 65 20 44 53 43 20 65 6e | 67 69 6e 65 65 72 73 2e |e DSC en|gineers.|
|000001e0| 20 57 68 69 6c 65 20 44 | 53 43 20 65 6e 67 69 6e | While D|SC engin|
|000001f0| 65 65 72 73 20 68 61 76 | 65 20 63 68 65 63 6b 65 |eers hav|e checke|
|00000200| 64 20 74 68 65 20 51 26 | 41 20 63 6f 6e 74 65 6e |d the Q&|A conten|
|00000210| 74 20 66 6f 72 20 61 63 | 63 75 72 61 63 79 2c 20 |t for ac|curacy, |
|00000220| 74 68 65 20 51 26 41 20 | 54 65 63 68 6e 69 63 61 |the Q&A |Technica|
|00000230| 6c 20 4e 6f 74 65 73 20 | 64 6f 6e d5 74 20 68 61 |l Notes |don.t ha|
|00000240| 76 65 20 74 68 65 20 65 | 64 69 74 69 6e 67 20 61 |ve the e|diting a|
|00000250| 6e 64 20 6f 72 67 61 6e | 69 7a 61 74 69 6f 6e 20 |nd organ|ization |
|00000260| 6f 66 20 6f 74 68 65 72 | 20 54 65 63 68 6e 69 63 |of other| Technic|
|00000270| 61 6c 20 4e 6f 74 65 73 | 2e 20 54 68 65 20 51 26 |al Notes|. The Q&|
|00000280| 41 20 66 75 6e 63 74 69 | 6f 6e 20 69 73 20 74 6f |A functi|on is to|
|00000290| 20 67 65 74 20 6e 65 77 | 20 74 65 63 68 6e 69 63 | get new| technic|
|000002a0| 61 6c 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 61 |al infor|mation a|
|000002b0| 6e 64 20 75 70 64 61 74 | 65 73 20 74 6f 20 79 6f |nd updat|es to yo|
|000002c0| 75 20 71 75 69 63 6b 6c | 79 2c 20 73 61 76 69 6e |u quickl|y, savin|
|000002d0| 67 20 74 68 65 20 70 6f | 6c 69 73 68 20 66 6f 72 |g the po|lish for|
|000002e0| 20 77 68 65 6e 20 74 68 | 65 20 69 6e 66 6f 72 6d | when th|e inform|
|000002f0| 61 74 69 6f 6e 20 6d 69 | 67 72 61 74 65 73 20 69 |ation mi|grates i|
|00000300| 6e 74 6f 20 72 65 66 65 | 72 65 6e 63 65 20 6d 61 |nto refe|rence ma|
|00000310| 6e 75 61 6c 73 2e 0d 51 | 26 41 73 20 61 72 65 20 |nuals..Q|&As are |
|00000320| 6e 6f 77 20 69 6e 63 6c | 75 64 65 64 20 77 69 74 |now incl|uded wit|
|00000330| 68 20 54 65 63 68 6e 69 | 63 61 6c 20 4e 6f 74 65 |h Techni|cal Note|
|00000340| 73 20 74 6f 20 6d 61 6b | 65 20 61 63 63 65 73 73 |s to mak|e access|
|00000350| 20 74 6f 20 74 65 63 68 | 6e 69 63 61 6c 20 75 70 | to tech|nical up|
|00000360| 64 61 74 65 73 20 65 61 | 73 69 65 72 20 66 6f 72 |dates ea|sier for|
|00000370| 20 79 6f 75 2e 20 49 66 | 20 79 6f 75 20 68 61 76 | you. If| you hav|
|00000380| 65 20 63 6f 6d 6d 65 6e | 74 73 20 6f 72 20 73 75 |e commen|ts or su|
|00000390| 67 67 65 73 74 69 6f 6e | 73 20 61 62 6f 75 74 20 |ggestion|s about |
|000003a0| 51 26 41 20 63 6f 6e 74 | 65 6e 74 20 6f 72 20 64 |Q&A cont|ent or d|
|000003b0| 69 73 74 72 69 62 75 74 | 69 6f 6e 2c 20 70 6c 65 |istribut|ion, ple|
|000003c0| 61 73 65 20 6c 65 74 20 | 75 73 20 6b 6e 6f 77 20 |ase let |us know |
|000003d0| 62 79 20 73 65 6e 64 69 | 6e 67 20 61 6e 20 41 70 |by sendi|ng an Ap|
|000003e0| 70 6c 65 4c 69 6e 6b 20 | 74 6f 20 44 45 56 46 45 |pleLink |to DEVFE|
|000003f0| 45 44 42 41 43 4b 2e 20 | 41 70 70 6c 65 20 50 61 |EDBACK. |Apple Pa|
|00000400| 72 74 6e 65 72 73 20 6d | 61 79 20 73 65 6e 64 20 |rtners m|ay send |
|00000410| 74 65 63 68 6e 69 63 61 | 6c 20 71 75 65 73 74 69 |technica|l questi|
|00000420| 6f 6e 73 20 61 62 6f 75 | 74 20 51 26 41 20 63 6f |ons abou|t Q&A co|
|00000430| 6e 74 65 6e 74 20 74 6f | 20 44 45 56 53 55 50 50 |ntent to| DEVSUPP|
|00000440| 4f 52 54 20 66 6f 72 20 | 72 65 73 6f 6c 75 74 69 |ORT for |resoluti|
|00000450| 6f 6e 2e 0d 4e 65 77 20 | 51 26 41 73 20 61 6e 64 |on..New |Q&As and|
|00000460| 20 51 26 41 73 20 72 65 | 76 69 73 65 64 20 74 68 | Q&As re|vised th|
|00000470| 69 73 20 6d 6f 6e 74 68 | 20 61 72 65 20 6d 61 72 |is month| are mar|
|00000480| 6b 65 64 20 77 69 74 68 | 20 61 20 62 61 72 20 69 |ked with| a bar i|
|00000490| 6e 20 74 68 65 20 73 69 | 64 65 20 6d 61 72 67 69 |n the si|de margi|
|000004a0| 6e 2e 0d 43 6f 6e 73 74 | 72 75 63 74 69 6f 6e 20 |n..Const|ruction |
|000004b0| 6f 66 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 0d |of Apple| events.|
|000004c0| 57 72 69 74 74 65 6e 3a | 09 34 2f 39 2f 39 31 0d |Written:|.4/9/91.|
|000004d0| 4c 61 73 74 20 72 65 76 | 69 65 77 65 64 3a 09 38 |Last rev|iewed:.8|
|000004e0| 2f 31 2f 39 32 0d 48 6f | 77 20 64 6f 20 49 20 70 |/1/92.Ho|w do I p|
|000004f0| 61 73 73 20 61 6e 20 41 | 70 70 6c 65 20 65 76 65 |ass an A|pple eve|
|00000500| 6e 74 20 74 6f 20 61 6e | 20 61 70 70 6c 69 63 61 |nt to an| applica|
|00000510| 74 69 6f 6e 20 61 74 20 | 6c 61 75 6e 63 68 20 74 |tion at |launch t|
|00000520| 69 6d 65 3f 0d 5f 5f 5f | 0d 59 6f 75 20 63 61 6e |ime?.___|.You can|
|00000530| 20 63 6f 65 72 63 65 20 | 74 68 65 20 27 6f 64 6f | coerce |the 'odo|
|00000540| 63 27 20 41 70 70 6c 65 | 20 65 76 65 6e 74 20 74 |c' Apple| event t|
|00000550| 6f 20 61 20 64 61 74 61 | 20 74 79 70 65 20 74 68 |o a data| type th|
|00000560| 61 74 20 64 6f 65 73 6e | d5 74 20 6e 65 65 64 20 |at doesn|.t need |
|00000570| 74 6f 20 62 65 20 70 72 | 65 2d 61 64 64 72 65 73 |to be pr|e-addres|
|00000580| 73 65 64 2e 41 20 73 61 | 6d 70 6c 65 20 63 61 6c |sed.A sa|mple cal|
|00000590| 6c 65 64 20 50 72 6f 63 | 44 6f 67 67 69 65 20 6f |led Proc|Doggie o|
|000005a0| 6e 20 74 68 65 20 44 65 | 76 65 6c 6f 70 65 72 20 |n the De|veloper |
|000005b0| 43 44 20 64 65 6d 6f 6e | 73 74 72 61 74 65 73 20 |CD demon|strates |
|000005c0| 74 68 69 73 20 2e 20 49 | 66 20 79 6f 75 20 6c 6f |this . I|f you lo|
|000005d0| 6f 6b 20 69 6e 20 74 68 | 65 20 55 50 72 6f 63 65 |ok in th|e UProce|
|000005e0| 73 73 55 74 69 6c 73 2e | 69 6e 63 31 2e 70 20 66 |ssUtils.|inc1.p f|
|000005f0| 69 6c 65 2c 20 79 6f 75 | d5 6c 6c 20 66 69 6e 64 |ile, you|.ll find|
|00000600| 20 74 68 69 73 20 63 6f | 6d 6d 65 6e 74 3a 0d d2 | this co|mment:..|
|00000610| 54 6f 20 63 72 65 61 74 | 65 20 74 68 65 20 6b 41 |To creat|e the kA|
|00000620| 45 4f 70 65 6e 44 6f 63 | 75 6d 65 6e 74 73 20 6f |EOpenDoc|uments o|
|00000630| 72 20 6b 41 45 50 72 69 | 6e 74 44 6f 63 75 6d 65 |r kAEPri|ntDocume|
|00000640| 6e 74 73 20 41 70 70 6c | 65 20 65 76 65 6e 74 2c |nts Appl|e event,|
|00000650| 20 61 20 74 61 72 67 65 | 74 20 61 64 64 72 65 73 | a targe|t addres|
|00000660| 73 20 64 65 73 63 72 69 | 70 74 6f 72 20 69 73 20 |s descri|ptor is |
|00000670| 6e 65 65 64 65 64 2e 20 | 42 65 63 61 75 73 65 20 |needed. |Because |
|00000680| 77 65 d5 72 65 20 63 6f | 6e 76 65 72 74 69 6e 67 |we.re co|nverting|
|00000690| 20 74 68 65 20 41 70 70 | 6c 65 20 65 76 65 6e 74 | the App|le event|
|000006a0| 20 69 6e 74 6f 20 61 20 | 74 79 70 65 41 70 70 50 | into a |typeAppP|
|000006b0| 61 72 61 6d 65 74 65 72 | 73 20 64 65 73 63 72 69 |arameter|s descri|
|000006c0| 70 74 6f 72 20 72 61 74 | 68 65 72 20 74 68 61 6e |ptor rat|her than|
|000006d0| 20 73 65 6e 64 69 6e 67 | 20 69 74 20 73 6f 6d 65 | sending| it some|
|000006e0| 77 68 65 72 65 2c 20 69 | 74 20 64 6f 65 73 6e d5 |where, i|t doesn.|
|000006f0| 74 20 6d 61 74 74 65 72 | 20 77 68 61 74 20 74 61 |t matter| what ta|
|00000700| 72 67 65 74 20 61 64 64 | 72 65 73 73 20 77 65 20 |rget add|ress we |
|00000710| 75 73 65 2e 20 49 20 6a | 75 73 74 20 75 73 65 64 |use. I j|ust used|
|00000720| 20 74 68 65 20 70 72 6f | 63 65 73 73 20 73 65 72 | the pro|cess ser|
|00000730| 69 61 6c 20 6e 75 6d 62 | 65 72 20 28 50 53 4e 29 |ial numb|er (PSN)|
|00000740| 20 6f 66 20 74 68 69 73 | 20 61 70 70 6c 69 63 61 | of this| applica|
|00000750| 74 69 6f 6e 20 61 73 20 | 61 20 64 75 6d 6d 79 20 |tion as |a dummy |
|00000760| 76 61 6c 75 65 2e 20 42 | 65 63 61 75 73 65 20 74 |value. B|ecause t|
|00000770| 68 69 73 20 69 73 20 61 | 6e 20 61 70 70 6c 69 63 |his is a|n applic|
|00000780| 61 74 69 6f 6e 20 61 6e | 64 20 6e 6f 74 20 73 6f |ation an|d not so|
|00000790| 6d 65 74 68 69 6e 67 20 | 6c 69 6b 65 20 61 20 64 |mething |like a d|
|000007a0| 72 69 76 65 72 2c 20 49 | 20 63 61 6e 20 6a 75 73 |river, I| can jus|
|000007b0| 74 20 75 73 65 20 74 68 | 65 20 d2 6b 43 75 72 72 |t use th|e .kCurr|
|000007c0| 65 6e 74 50 72 6f 63 65 | 73 73 d3 20 63 6f 6e 73 |entProce|ss. cons|
|000007d0| 74 61 6e 74 20 74 6f 20 | 72 65 70 72 65 73 65 6e |tant to |represen|
|000007e0| 74 20 74 68 69 73 20 61 | 70 70 6c 69 63 61 74 69 |t this a|pplicati|
|000007f0| 6f 6e d5 73 20 50 53 4e | 2e 20 41 20 64 65 73 63 |on.s PSN|. A desc|
|00000800| 72 69 70 74 6f 72 20 69 | 73 20 6d 61 64 65 20 6f |riptor i|s made o|
|00000810| 66 20 74 68 69 73 20 50 | 53 4e 2c 20 74 68 65 6e |f this P|SN, then|
|00000820| 20 74 68 69 73 20 50 53 | 4e 20 69 73 20 75 73 65 | this PS|N is use|
|00000830| 64 20 77 68 65 6e 20 63 | 72 65 61 74 69 6e 67 20 |d when c|reating |
|00000840| 74 68 65 20 6e 65 77 20 | 6b 41 45 4f 70 65 6e 44 |the new |kAEOpenD|
|00000850| 6f 63 75 6d 65 6e 74 73 | 20 41 70 70 6c 65 45 76 |ocuments| AppleEv|
|00000860| 65 6e 74 2e 20 4f 6e 63 | 65 20 74 68 69 73 20 41 |ent. Onc|e this A|
|00000870| 70 70 6c 65 20 65 76 65 | 6e 74 20 69 73 20 63 72 |pple eve|nt is cr|
|00000880| 65 61 74 65 64 2c 20 74 | 68 65 20 50 53 4e 20 64 |eated, t|he PSN d|
|00000890| 65 73 63 72 69 70 74 6f | 72 20 69 73 20 6e 6f 20 |escripto|r is no |
|000008a0| 6c 6f 6e 67 65 72 20 6e | 65 65 64 65 64 20 61 6e |longer n|eeded an|
|000008b0| 64 20 69 73 20 64 69 73 | 70 6f 73 65 64 20 6f 66 |d is dis|posed of|
|000008c0| 2e d3 0d 49 6e 20 6f 74 | 68 65 72 20 77 6f 72 64 |...In ot|her word|
|000008d0| 73 2c 20 79 6f 75 20 6a | 75 73 74 20 64 75 6d 6d |s, you j|ust dumm|
|000008e0| 79 20 75 70 20 61 6e 20 | 61 64 64 72 65 73 73 20 |y up an |address |
|000008f0| 61 6e 64 20 63 6f 65 72 | 63 65 20 74 68 65 20 64 |and coer|ce the d|
|00000900| 65 73 63 72 69 70 74 6f | 72 20 74 6f 20 62 65 20 |escripto|r to be |
|00000910| 6f 66 20 74 79 70 65 20 | 74 79 70 65 41 70 70 50 |of type |typeAppP|
|00000920| 61 72 61 6d 65 74 65 72 | 73 2c 20 61 6e 64 20 74 |arameter|s, and t|
|00000930| 68 65 20 61 64 64 72 65 | 73 73 20 77 69 6c 6c 20 |he addre|ss will |
|00000940| 62 65 20 63 6f 72 72 65 | 63 74 65 64 20 66 6f 72 |be corre|cted for|
|00000950| 20 79 6f 75 20 62 79 20 | 74 68 65 20 41 70 70 6c | you by |the Appl|
|00000960| 65 45 76 65 6e 74 73 20 | 4d 61 6e 61 67 65 72 2e |eEvents |Manager.|
|00000970| 20 50 6c 65 61 73 65 20 | 72 65 66 65 72 20 74 6f | Please |refer to|
|00000980| 20 74 68 65 20 50 72 6f | 63 44 6f 67 67 69 65 20 | the Pro|cDoggie |
|00000990| 73 61 6d 70 6c 65 20 73 | 6f 75 72 63 65 20 63 6f |sample s|ource co|
|000009a0| 64 65 20 6f 72 20 74 6f | 20 4c 61 75 6e 63 68 57 |de or to| LaunchW|
|000009b0| 69 74 68 44 6f 63 20 28 | 69 6e 20 74 68 65 20 53 |ithDoc (|in the S|
|000009c0| 6e 69 70 70 65 74 73 20 | 63 6f 6c 6c 65 63 74 69 |nippets |collecti|
|000009d0| 6f 6e 29 20 66 6f 72 20 | 74 68 65 20 63 6f 6d 70 |on) for |the comp|
|000009e0| 6c 65 74 65 20 70 69 63 | 74 75 72 65 20 6f 66 20 |lete pic|ture of |
|000009f0| 68 6f 77 20 74 68 69 73 | 20 69 73 20 64 6f 6e 65 |how this| is done|
|00000a00| 2e 0d 41 70 70 6c 65 20 | 65 76 65 6e 74 20 61 70 |..Apple |event ap|
|00000a10| 70 6c 69 63 61 74 69 6f | 6e 20 65 72 72 6f 72 20 |plicatio|n error |
|00000a20| 68 61 6e 64 6c 69 6e 67 | 0d 57 72 69 74 74 65 6e |handling|.Written|
|00000a30| 3a 09 37 2f 32 32 2f 39 | 31 0d 4c 61 73 74 20 72 |:.7/22/9|1.Last r|
|00000a40| 65 76 69 65 77 65 64 3a | 09 38 2f 31 2f 39 32 0d |eviewed:|.8/1/92.|
|00000a50| 57 68 61 74 20 64 6f 20 | 77 65 20 72 65 74 75 72 |What do |we retur|
|00000a60| 6e 20 74 6f 20 74 68 65 | 20 41 70 70 6c 65 20 65 |n to the| Apple e|
|00000a70| 76 65 6e 74 20 68 61 6e | 64 6c 65 72 20 69 66 20 |vent han|dler if |
|00000a80| 77 65 20 67 65 74 20 61 | 6e 20 61 70 70 6c 69 63 |we get a|n applic|
|00000a90| 61 74 69 6f 6e 20 65 72 | 72 6f 72 20 77 68 69 6c |ation er|ror whil|
|00000aa0| 65 20 70 72 6f 63 65 73 | 73 69 6e 67 20 61 20 73 |e proces|sing a s|
|00000ab0| 74 61 6e 64 61 72 64 20 | 65 76 65 6e 74 2c 20 45 |tandard |event, E|
|00000ac0| 64 69 74 69 6f 6e 20 4d | 61 6e 61 67 65 72 20 65 |dition M|anager e|
|00000ad0| 76 65 6e 74 2c 20 6f 72 | 20 63 75 73 74 6f 6d 20 |vent, or| custom |
|00000ae0| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 66 6f 72 20 |Apple ev|ent for |
|00000af0| 63 6f 6d 6d 61 6e 64 73 | 20 61 6e 64 20 71 75 65 |commands| and que|
|00000b00| 72 69 65 73 3f 20 50 72 | 6f 62 61 62 6c 79 20 6e |ries? Pr|obably n|
|00000b10| 6f 74 20 65 72 72 41 45 | 4e 6f 74 48 61 6e 64 6c |ot errAE|NotHandl|
|00000b20| 65 64 2c 20 73 69 6e 63 | 65 20 74 68 61 74 20 6d |ed, sinc|e that m|
|00000b30| 65 61 6e 73 20 77 65 20 | 64 69 64 6e d5 74 20 68 |eans we |didn.t h|
|00000b40| 61 6e 64 6c 65 20 74 68 | 65 20 65 76 65 6e 74 2c |andle th|e event,|
|00000b50| 20 77 68 69 63 68 20 69 | 73 20 64 69 66 66 65 72 | which i|s differ|
|00000b60| 65 6e 74 20 66 72 6f 6d | 20 74 72 79 69 6e 67 20 |ent from| trying |
|00000b70| 74 6f 20 68 61 6e 64 6c | 65 20 69 74 20 61 6e 64 |to handl|e it and|
|00000b80| 20 66 61 69 6c 69 6e 67 | 2e 20 57 6f 75 6c 64 20 | failing|. Would |
|00000b90| 69 74 20 62 65 20 65 72 | 72 41 45 46 61 69 6c 3f |it be er|rAEFail?|
|00000ba0| 20 57 68 61 74 20 69 66 | 20 77 65 20 77 61 6e 74 | What if| we want|
|00000bb0| 20 74 6f 20 72 65 74 75 | 72 6e 20 6d 6f 72 65 20 | to retu|rn more |
|00000bc0| 73 70 65 63 69 66 69 63 | 20 65 72 72 6f 72 20 69 |specific| error i|
|00000bd0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 3f 20 44 6f 20 77 |nformati|on? Do w|
|00000be0| 65 20 64 65 66 69 6e 65 | 20 6f 75 72 20 6f 77 6e |e define| our own|
|00000bf0| 20 65 72 72 6f 72 73 2c | 20 6f 72 20 74 72 79 20 | errors,| or try |
|00000c00| 74 6f 20 75 73 65 20 41 | 70 70 6c 65 d5 73 20 65 |to use A|pple.s e|
|00000c10| 72 72 6f 72 73 20 73 75 | 63 68 20 61 73 20 6d 65 |rrors su|ch as me|
|00000c20| 6d 46 75 6c 6c 45 72 72 | 20 6f 72 20 70 61 72 6d |mFullErr| or parm|
|00000c30| 45 72 72 3f 0d 5f 5f 5f | 0d 59 6f 75 20 70 61 73 |Err?.___|.You pas|
|00000c40| 73 20 62 61 63 6b 20 65 | 72 72 41 45 4e 6f 74 48 |s back e|rrAENotH|
|00000c50| 61 6e 64 6c 65 64 2c 20 | 62 65 63 61 75 73 65 20 |andled, |because |
|00000c60| 69 74 d5 73 20 74 72 75 | 65 2c 20 61 6e 64 20 62 |it.s tru|e, and b|
|00000c70| 65 63 61 75 73 65 20 73 | 6f 6d 65 20 73 69 6d 70 |ecause s|ome simp|
|00000c80| 6c 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |le appli|cations |
|00000c90| 77 69 6c 6c 20 6e 6f 74 | 20 62 65 20 61 62 6c 65 |will not| be able|
|00000ca0| 20 74 6f 20 68 61 6e 64 | 6c 65 20 61 6e 79 74 68 | to hand|le anyth|
|00000cb0| 69 6e 67 20 6d 6f 72 65 | 20 74 68 61 6e 20 74 68 |ing more| than th|
|00000cc0| 61 74 2e 20 57 68 61 74 | 20 79 6f 75 20 63 61 6e |at. What| you can|
|00000cd0| 20 61 6c 73 6f 20 64 6f | 2c 20 61 6e 64 20 77 68 | also do|, and wh|
|00000ce0| 61 74 20 6d 6f 73 74 20 | 63 6f 6d 6d 65 72 63 69 |at most |commerci|
|00000cf0| 61 6c 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |al appli|cations |
|00000d00| 77 69 6c 6c 20 64 6f 20 | 28 70 61 72 74 69 63 75 |will do |(particu|
|00000d10| 6c 61 72 6c 79 20 61 70 | 70 6c 69 63 61 74 69 6f |larly ap|plicatio|
|00000d20| 6e 73 20 74 68 61 74 20 | 77 61 6e 74 20 74 6f 20 |ns that |want to |
|00000d30| 62 65 20 73 63 72 69 70 | 74 69 6e 67 20 73 61 76 |be scrip|ting sav|
|00000d40| 76 79 29 2c 20 69 73 20 | 61 64 64 20 65 72 72 6e |vy), is |add errn|
|00000d50| 20 61 6e 64 20 65 72 72 | 73 20 70 61 72 61 6d 65 | and err|s parame|
|00000d60| 74 65 72 73 20 74 6f 20 | 74 68 65 20 72 65 70 6c |ters to |the repl|
|00000d70| 79 20 72 65 63 6f 72 64 | 20 66 6f 72 20 74 68 61 |y record| for tha|
|00000d80| 74 20 65 76 65 6e 74 20 | 28 61 73 20 73 68 6f 77 |t event |(as show|
|00000d90| 6e 20 6f 6e 20 70 61 67 | 65 20 36 2d 34 39 20 6f |n on pag|e 6-49 o|
|00000da0| 66 20 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |f Inside| Macinto|
|00000db0| 73 68 20 56 6f 6c 75 6d | 65 20 56 49 29 2e 20 59 |sh Volum|e VI). Y|
|00000dc0| 6f 75 20 63 61 6e 20 62 | 65 20 61 73 20 64 65 73 |ou can b|e as des|
|00000dd0| 63 72 69 70 74 69 76 65 | 20 61 73 20 79 6f 75 20 |criptive| as you |
|00000de0| 6c 69 6b 65 20 69 6e 20 | 74 68 65 20 74 65 78 74 |like in |the text|
|00000df0| d1 74 68 65 20 6d 6f 72 | 65 20 74 68 65 20 62 65 |.the mor|e the be|
|00000e00| 74 74 65 72 2c 20 69 6e | 20 66 61 63 74 2c 20 73 |tter, in| fact, s|
|00000e10| 69 6e 63 65 20 74 68 69 | 73 20 74 65 78 74 20 77 |ince thi|s text w|
|00000e20| 69 6c 6c 20 62 65 20 73 | 65 65 6e 20 61 74 20 74 |ill be s|een at t|
|00000e30| 68 65 20 75 73 65 72 20 | 6c 65 76 65 6c 20 75 73 |he user |level us|
|00000e40| 75 61 6c 6c 79 2e 20 54 | 68 65 20 65 72 72 6e 20 |ually. T|he errn |
|00000e50| 76 61 6c 75 65 20 79 6f | 75 20 70 61 73 73 20 62 |value yo|u pass b|
|00000e60| 61 63 6b 20 63 61 6e 20 | 62 65 20 74 68 65 20 73 |ack can |be the s|
|00000e70| 79 73 74 65 6d 20 65 72 | 72 6f 72 20 6e 75 6d 62 |ystem er|ror numb|
|00000e80| 65 72 3b 20 74 68 65 6e | 20 74 68 65 20 73 65 6e |er; then| the sen|
|00000e90| 64 69 6e 67 20 70 72 6f | 67 72 61 6d 20 6d 61 79 |ding pro|gram may|
|00000ea0| 20 62 65 20 61 62 6c 65 | 20 74 6f 20 72 65 63 6f | be able| to reco|
|00000eb0| 76 65 72 20 61 6e 64 20 | 74 72 79 20 61 67 61 69 |ver and |try agai|
|00000ec0| 6e 2e 0d 41 70 70 6c 65 | 20 65 76 65 6e 74 73 20 |n..Apple| events |
|00000ed0| 74 6f 20 79 6f 75 72 73 | 65 6c 66 20 62 79 70 61 |to yours|elf bypa|
|00000ee0| 73 73 20 57 61 69 74 4e | 65 78 74 45 76 65 6e 74 |ss WaitN|extEvent|
|00000ef0| 20 70 72 6f 63 65 73 73 | 69 6e 67 0d 57 72 69 74 | process|ing.Writ|
|00000f00| 74 65 6e 3a 09 38 2f 31 | 32 2f 39 31 0d 4c 61 73 |ten:.8/1|2/91.Las|
|00000f10| 74 20 72 65 76 69 65 77 | 65 64 3a 09 38 2f 31 2f |t review|ed:.8/1/|
|00000f20| 39 32 0d 49 66 20 49 20 | 73 65 6e 64 20 41 70 70 |92.If I |send App|
|00000f30| 6c 65 20 65 76 65 6e 74 | 73 20 74 6f 20 6d 79 73 |le event|s to mys|
|00000f40| 65 6c 66 20 61 6e 64 20 | 73 70 65 63 69 66 79 20 |elf and |specify |
|00000f50| 6b 41 45 51 75 65 75 65 | 52 65 70 6c 79 20 74 6f |kAEQueue|Reply to|
|00000f60| 20 41 45 53 65 6e 64 2c | 20 74 68 65 20 65 76 65 | AESend,| the eve|
|00000f70| 6e 74 20 64 6f 65 73 20 | 6e 6f 74 20 67 65 74 20 |nt does |not get |
|00000f80| 70 75 74 20 69 6e 20 74 | 68 65 20 71 75 65 75 65 |put in t|he queue|
|00000f90| 20 6c 69 6b 65 20 49 20 | 61 73 6b 65 64 20 66 6f | like I |asked fo|
|00000fa0| 72 2e 20 49 74 20 73 68 | 6f 77 73 20 75 70 20 69 |r. It sh|ows up i|
|00000fb0| 6d 6d 65 64 69 61 74 65 | 6c 79 20 69 6e 20 74 68 |mmediate|ly in th|
|00000fc0| 65 20 72 65 70 6c 79 20 | 70 61 72 61 6d 65 74 65 |e reply |paramete|
|00000fd0| 72 2e 20 41 63 63 6f 72 | 64 69 6e 67 20 74 6f 20 |r. Accor|ding to |
|00000fe0| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00000ff0| 2c 20 69 66 20 49 20 73 | 70 65 63 69 66 79 20 6b |, if I s|pecify k|
|00001000| 41 45 51 75 65 75 65 52 | 65 70 6c 79 20 49 20 73 |AEQueueR|eply I s|
|00001010| 68 6f 75 6c 64 20 74 72 | 65 61 74 20 74 68 65 20 |hould tr|eat the |
|00001020| 72 65 70 6c 79 20 65 76 | 65 6e 74 20 61 73 20 75 |reply ev|ent as u|
|00001030| 6e 64 65 66 69 6e 65 64 | 2e 20 50 6c 65 61 73 65 |ndefined|. Please|
|00001040| 20 68 65 6c 70 3b 20 6d | 79 20 61 70 70 20 66 61 | help; m|y app fa|
|00001050| 6c 6c 73 20 61 70 61 72 | 74 20 62 65 63 61 75 73 |lls apar|t becaus|
|00001060| 65 20 69 74 20 6e 65 76 | 65 72 20 72 65 63 65 69 |e it nev|er recei|
|00001070| 76 65 73 20 74 68 65 20 | 65 76 65 6e 74 20 69 74 |ves the |event it|
|00001080| 20 69 73 20 73 75 70 70 | 6f 73 65 64 20 74 6f 2e | is supp|osed to.|
|00001090| 20 49 66 20 74 68 69 73 | 20 69 73 20 61 20 62 75 | If this| is a bu|
|000010a0| 67 2c 20 77 69 6c 6c 20 | 74 68 65 20 62 65 68 61 |g, will |the beha|
|000010b0| 76 69 6f 72 20 62 65 20 | 63 68 61 6e 67 65 64 20 |vior be |changed |
|000010c0| 69 6e 20 74 68 65 20 66 | 75 74 75 72 65 3f 0d 5f |in the f|uture?._|
|000010d0| 5f 5f 0d 54 68 69 73 20 | 69 73 20 6e 6f 74 20 61 |__.This |is not a|
|000010e0| 20 62 75 67 2c 20 69 74 | d5 73 20 61 6e 20 75 6e | bug, it|.s an un|
|000010f0| 64 6f 63 75 6d 65 6e 74 | 65 64 20 d2 66 65 61 74 |document|ed .feat|
|00001100| 75 72 65 d3 20 6f 66 20 | 74 68 65 20 41 70 70 6c |ure. of |the Appl|
|00001110| 65 20 45 76 65 6e 74 20 | 4d 61 6e 61 67 65 72 2e |e Event |Manager.|
|00001120| 20 49 66 20 79 6f 75 20 | 73 65 6e 64 20 61 6e 20 | If you |send an |
|00001130| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 74 6f 20 79 |Apple ev|ent to y|
|00001140| 6f 75 72 73 65 6c 66 2c | 20 74 68 65 20 41 70 70 |ourself,| the App|
|00001150| 6c 65 20 45 76 65 6e 74 | 20 4d 61 6e 61 67 65 72 |le Event| Manager|
|00001160| 20 2a 64 69 72 65 63 74 | 6c 79 20 64 69 73 70 61 | *direct|ly dispa|
|00001170| 74 63 68 65 73 2a 20 74 | 6f 20 74 68 65 20 68 61 |tches* t|o the ha|
|00001180| 6e 64 6c 65 72 20 79 6f | 75 20 68 61 76 65 20 69 |ndler yo|u have i|
|00001190| 6e 73 74 61 6c 6c 65 64 | 20 66 6f 72 20 74 68 61 |nstalled| for tha|
|000011a0| 74 20 65 76 65 6e 74 2e | 20 53 6f 20 41 70 70 6c |t event.| So Appl|
|000011b0| 65 20 65 76 65 6e 74 73 | 20 79 6f 75 20 73 65 6e |e events| you sen|
|000011c0| 64 20 74 6f 20 79 6f 75 | 72 73 65 6c 66 20 64 6f |d to you|rself do|
|000011d0| 20 6e 6f 74 20 63 6f 6d | 65 20 69 6e 20 74 68 72 | not com|e in thr|
|000011e0| 6f 75 67 68 20 57 61 69 | 74 4e 65 78 74 45 76 65 |ough Wai|tNextEve|
|000011f0| 6e 74 2e 0d 54 68 69 73 | 20 6d 65 61 6e 73 20 74 |nt..This| means t|
|00001200| 68 61 74 20 69 66 20 79 | 6f 75 20 72 65 70 6c 79 |hat if y|ou reply|
|00001210| 20 74 6f 20 61 6e 20 41 | 70 70 6c 65 20 65 76 65 | to an A|pple eve|
|00001220| 6e 74 20 79 6f 75 20 73 | 65 6e 74 20 79 6f 75 72 |nt you s|ent your|
|00001230| 73 65 6c 66 2c 20 74 68 | 65 6e 20 79 6f 75 72 20 |self, th|en your |
|00001240| 27 61 6e 73 72 27 20 68 | 61 6e 64 6c 65 72 20 77 |'ansr' h|andler w|
|00001250| 69 6c 6c 20 67 65 74 20 | 63 61 6c 6c 65 64 20 64 |ill get |called d|
|00001260| 69 72 65 63 74 6c 79 2e | 20 54 68 69 73 20 77 61 |irectly.| This wa|
|00001270| 73 20 6e 6f 74 20 61 6e | 20 61 72 62 69 74 72 61 |s not an| arbitra|
|00001280| 72 79 20 64 65 63 69 73 | 69 6f 6e 2c 20 74 68 6f |ry decis|ion, tho|
|00001290| 75 67 68 20 69 74 20 63 | 61 6e 20 68 61 76 65 20 |ugh it c|an have |
|000012a0| 73 6f 6d 65 20 63 6f 6e | 66 75 73 69 6e 67 20 20 |some con|fusing |
|000012b0| 72 61 6d 69 66 69 63 61 | 74 69 6f 6e 20 66 6f 72 |ramifica|tion for|
|000012c0| 20 61 6e 20 61 70 70 6c | 69 63 61 74 69 6f 6e 2e | an appl|ication.|
|000012d0| 20 54 77 6f 20 66 61 63 | 74 6f 72 73 20 69 6e 66 | Two fac|tors inf|
|000012e0| 6c 75 65 6e 63 65 64 20 | 74 68 65 20 64 65 63 69 |luenced |the deci|
|000012f0| 73 69 6f 6e 2c 20 74 68 | 65 20 20 66 69 72 73 74 |sion, th|e first|
|00001300| 20 6d 69 6e 6f 72 2c 20 | 74 68 65 20 73 65 63 6f | minor, |the seco|
|00001310| 6e 64 20 6d 61 6a 6f 72 | 3a 0d 31 29 20 53 70 65 |nd major|:.1) Spe|
|00001320| 65 64 2e 20 54 68 65 20 | 41 70 70 6c 65 20 45 76 |ed. The |Apple Ev|
|00001330| 65 6e 74 20 4d 61 6e 61 | 67 65 72 20 68 61 73 20 |ent Mana|ger has |
|00001340| 61 6c 6c 20 74 68 65 20 | 68 61 6e 64 6c 65 72 73 |all the |handlers|
|00001350| 20 66 6f 72 20 79 6f 75 | 72 20 61 70 70 6c 69 63 | for you|r applic|
|00001360| 61 74 69 6f 6e 20 69 6e | 20 20 61 20 68 61 73 68 |ation in| a hash|
|00001370| 65 64 20 74 61 62 6c 65 | 2c 20 61 6e 64 20 63 61 |ed table|, and ca|
|00001380| 6e 20 64 69 73 70 61 74 | 63 68 20 56 45 52 59 20 |n dispat|ch VERY |
|00001390| 71 75 69 63 6b 6c 79 20 | 74 6f 20 74 68 65 6d 2c |quickly |to them,|
|000013a0| 20 73 6f 20 66 6f 72 20 | 70 65 72 66 6f 72 6d 61 | so for |performa|
|000013b0| 6e 63 65 20 20 72 65 61 | 73 6f 6e 73 20 64 69 72 |nce rea|sons dir|
|000013c0| 65 63 74 20 64 69 73 70 | 61 74 63 68 69 6e 67 20 |ect disp|atching |
|000013d0| 77 61 73 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 2e |was impl|emented.|
|000013e0| 0d 32 29 20 45 76 65 6e | 74 20 70 72 69 6f 72 69 |.2) Even|t priori|
|000013f0| 74 69 65 73 20 61 6e 64 | 20 73 65 71 75 65 6e 63 |ties and| sequenc|
|00001400| 69 6e 67 2e 20 41 70 70 | 6c 65 20 65 76 65 6e 74 |ing. App|le event|
|00001410| 73 20 68 61 76 65 20 61 | 20 6c 6f 77 65 72 20 70 |s have a| lower p|
|00001420| 72 69 6f 72 69 74 79 20 | 74 68 61 6e 20 75 73 65 |riority |than use|
|00001430| 72 2d 67 65 6e 65 72 61 | 74 65 64 20 65 76 65 6e |r-genera|ted even|
|00001440| 74 73 20 28 6b 65 79 73 | 2c 20 63 6c 69 63 6b 73 |ts (keys|, clicks|
|00001450| 29 2c 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 20 |), Apple| events |
|00001460| 63 6f 6d 65 20 69 6e 20 | 72 69 67 68 74 20 62 65 |come in |right be|
|00001470| 66 6f 72 65 20 55 70 64 | 61 74 65 20 65 76 65 6e |fore Upd|ate even|
|00001480| 74 73 2e 20 54 68 69 73 | 20 63 72 65 61 74 65 64 |ts. This| created|
|00001490| 20 61 20 70 6f 74 65 6e | 74 69 61 6c 6c 79 20 73 | a poten|tially s|
|000014a0| 65 72 69 6f 75 73 20 70 | 72 6f 62 6c 65 6d 20 66 |erious p|roblem f|
|000014b0| 6f 72 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |or appli|cations |
|000014c0| 74 68 61 74 20 73 65 6e | 74 20 41 70 70 6c 65 20 |that sen|t Apple |
|000014d0| 65 76 65 6e 74 73 20 74 | 6f 20 74 68 65 6d 73 65 |events t|o themse|
|000014e0| 6c 76 65 73 2e 0d 49 66 | 20 61 6c 6c 20 41 70 70 |lves..If| all App|
|000014f0| 6c 65 20 65 76 65 6e 74 | 73 20 63 61 6d 65 20 74 |le event|s came t|
|00001500| 68 72 6f 75 67 68 20 74 | 68 65 20 65 76 65 6e 74 |hrough t|he event|
|00001510| 20 6c 6f 6f 70 2c 20 74 | 68 65 20 66 6f 6c 6c 6f | loop, t|he follo|
|00001520| 77 69 6e 67 20 73 63 65 | 6e 61 72 69 6f 20 63 6f |wing sce|nario co|
|00001530| 75 6c 64 20 76 65 72 79 | 20 65 61 73 69 6c 79 20 |uld very| easily |
|00001540| 62 65 20 63 72 65 61 74 | 65 64 3a 0d a5 20 55 73 |be creat|ed:.. Us|
|00001550| 65 72 20 73 65 6c 65 63 | 74 73 20 6d 65 6e 75 20 |er selec|ts menu |
|00001560| 69 74 65 6d 2c 20 61 70 | 70 6c 69 63 61 74 69 6f |item, ap|plicatio|
|00001570| 6e 20 73 65 6e 64 73 20 | 61 6e 20 41 70 70 6c 65 |n sends |an Apple|
|00001580| 20 65 76 65 6e 74 20 74 | 6f 20 69 74 73 65 6c 66 | event t|o itself|
|00001590| 20 69 6e 20 72 65 73 70 | 6f 6e 73 65 2c 20 61 6e | in resp|onse, an|
|000015a0| 64 20 74 68 69 73 20 41 | 70 70 6c 65 20 65 76 65 |d this A|pple eve|
|000015b0| 6e 74 20 72 65 71 75 69 | 72 65 73 20 61 20 72 65 |nt requi|res a re|
|000015c0| 70 6c 79 20 6f 72 20 77 | 69 6c 6c 20 63 61 75 73 |ply or w|ill caus|
|000015d0| 65 20 6f 74 68 65 72 20 | 41 70 70 6c 65 20 65 76 |e other |Apple ev|
|000015e0| 65 6e 74 73 20 74 6f 20 | 62 65 20 73 65 6e 74 2e |ents to |be sent.|
|000015f0| 0d a5 20 55 73 65 72 20 | 63 6c 69 63 6b 73 20 77 |.. User |clicks w|
|00001600| 69 74 68 20 74 68 65 20 | 6d 6f 75 73 65 20 69 6e |ith the |mouse in|
|00001610| 20 61 6e 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | an appl|ication |
|00001620| 77 69 6e 64 6f 77 2e 0d | 54 68 65 20 6d 6f 75 73 |window..|The mous|
|00001630| 65 20 63 6c 69 63 6b 20 | 77 6f 75 6c 64 20 68 61 |e click |would ha|
|00001640| 76 65 20 61 20 68 69 67 | 68 65 72 20 70 72 69 6f |ve a hig|her prio|
|00001650| 72 69 74 79 20 74 68 61 | 6e 20 74 68 65 20 72 65 |rity tha|n the re|
|00001660| 70 6c 79 20 6f 72 20 61 | 6e 79 20 41 70 70 6c 65 |ply or a|ny Apple|
|00001670| 20 65 76 65 6e 74 73 20 | 74 68 61 74 20 61 72 65 | events |that are|
|00001680| 20 73 65 6e 74 20 69 6e | 20 72 65 73 70 6f 6e 73 | sent in| respons|
|00001690| 65 20 74 6f 20 74 68 65 | 20 66 69 72 73 74 20 41 |e to the| first A|
|000016a0| 70 70 6c 65 20 65 76 65 | 6e 74 2c 20 61 6e 64 20 |pple eve|nt, and |
|000016b0| 77 6f 75 6c 64 20 67 65 | 74 20 70 6f 73 74 65 64 |would ge|t posted|
|000016c0| 20 61 68 65 61 64 20 6f | 66 20 74 68 65 20 41 70 | ahead o|f the Ap|
|000016d0| 70 6c 65 20 65 76 65 6e | 74 20 69 6e 20 74 68 65 |ple even|t in the|
|000016e0| 20 65 76 65 6e 74 20 71 | 75 65 75 65 2e 20 57 68 | event q|ueue. Wh|
|000016f0| 69 63 68 20 77 6f 75 6c | 64 20 6d 65 61 6e 20 74 |ich woul|d mean t|
|00001700| 68 61 74 20 74 68 65 20 | 6d 6f 75 73 65 20 63 6c |hat the |mouse cl|
|00001710| 69 63 6b 20 77 6f 75 6c | 64 20 68 61 70 70 65 6e |ick woul|d happen|
|00001720| 20 61 6e 64 20 63 6f 6e | 63 65 69 76 61 62 6c 79 | and con|ceivably|
|00001730| 20 63 68 61 6e 67 65 20 | 74 68 65 20 63 75 72 72 | change |the curr|
|00001740| 65 6e 74 20 63 6f 6e 74 | 65 78 74 20 6f 66 20 74 |ent cont|ext of t|
|00001750| 68 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 28 |he appli|cation (|
|00001760| 70 65 72 68 61 70 73 20 | 73 77 69 74 63 68 69 6e |perhaps |switchin|
|00001770| 67 20 77 69 6e 64 6f 77 | 73 2c 20 66 6f 72 20 65 |g window|s, for e|
|00001780| 78 61 6d 70 6c 65 29 3b | 20 74 68 65 6e 20 77 68 |xample);| then wh|
|00001790| 65 6e 20 74 68 65 20 41 | 70 70 6c 65 20 65 76 65 |en the A|pple eve|
|000017a0| 6e 74 73 20 73 65 6e 74 | 20 62 79 20 74 68 65 20 |nts sent| by the |
|000017b0| 6d 65 6e 75 20 69 74 65 | 6d 20 68 61 6e 64 6c 65 |menu ite|m handle|
|000017c0| 72 20 77 65 72 65 20 70 | 72 6f 63 65 73 73 65 64 |r were p|rocessed|
|000017d0| 20 74 68 72 6f 75 67 68 | 20 74 68 65 20 71 75 65 | through| the que|
|000017e0| 75 65 2c 20 74 68 65 20 | 61 70 70 6c 69 63 61 74 |ue, the |applicat|
|000017f0| 69 6f 6e 20 73 74 61 74 | 65 20 77 6f 75 6c 64 20 |ion stat|e would |
|00001800| 2a 6e 6f 74 2a 20 62 65 | 20 74 68 65 20 73 61 6d |*not* be| the sam|
|00001810| 65 20 61 73 20 69 74 20 | 77 61 73 20 77 68 65 6e |e as it |was when|
|00001820| 20 74 68 65 20 6d 65 6e | 75 20 73 65 6c 65 63 74 | the men|u select|
|00001830| 69 6f 6e 20 77 61 73 20 | 6d 61 64 65 2c 20 61 6e |ion was |made, an|
|00001840| 64 20 74 68 65 20 6d 65 | 6e 75 20 73 65 6c 65 63 |d the me|nu selec|
|00001850| 74 69 6f 6e 20 6d 61 79 | 20 62 65 20 74 6f 74 61 |tion may| be tota|
|00001860| 6c 6c 79 20 69 6e 61 70 | 70 72 6f 70 72 69 61 74 |lly inap|propriat|
|00001870| 65 20 66 6f 72 20 74 68 | 65 20 63 75 72 72 65 6e |e for th|e curren|
|00001880| 74 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 2e |t config|uration.|
|00001890| 0d 53 6f 2c 20 74 6f 20 | 70 72 65 76 65 6e 74 20 |.So, to |prevent |
|000018a0| 61 20 6c 6f 73 73 20 6f | 66 20 73 65 71 75 65 6e |a loss o|f sequen|
|000018b0| 63 69 6e 67 2c 20 74 68 | 65 20 41 70 70 6c 65 20 |cing, th|e Apple |
|000018c0| 45 76 65 6e 74 20 4d 61 | 6e 61 67 65 72 20 28 41 |Event Ma|nager (A|
|000018d0| 45 4d 29 20 64 69 72 65 | 63 74 6c 79 20 20 64 69 |EM) dire|ctly di|
|000018e0| 73 70 61 74 63 68 65 73 | 2e 20 41 6e 79 20 6e 6f |spatches|. Any no|
|000018f0| 6e 2d 41 70 70 6c 65 20 | 65 76 65 6e 74 73 20 74 |n-Apple |events t|
|00001900| 68 61 74 20 68 61 70 70 | 65 6e 20 77 68 69 6c 65 |hat happ|en while|
|00001910| 20 79 6f 75 d5 72 65 20 | 73 65 6e 64 69 6e 67 20 | you.re |sending |
|00001920| 61 6e 64 20 70 72 6f 63 | 65 73 73 69 6e 67 20 61 |and proc|essing a|
|00001930| 6e 20 41 70 70 6c 65 20 | 65 76 65 6e 74 20 74 6f |n Apple |event to|
|00001940| 20 79 6f 75 72 73 65 6c | 66 20 77 69 6c 6c 20 62 | yoursel|f will b|
|00001950| 65 20 71 75 65 75 65 64 | 20 61 6e 64 20 6e 6f 74 |e queued| and not|
|00001960| 20 69 6e 74 65 72 72 75 | 70 74 20 74 68 65 20 41 | interru|pt the A|
|00001970| 70 70 6c 65 20 65 76 65 | 6e 74 20 70 72 6f 63 65 |pple eve|nt proce|
|00001980| 73 73 20 79 6f 75 d5 76 | 65 20 69 6e 69 74 69 61 |ss you.v|e initia|
|00001990| 74 65 64 2e 0d 57 68 61 | 74 20 74 68 69 73 20 6d |ted..Wha|t this m|
|000019a0| 65 61 6e 73 20 69 6e 20 | 74 68 65 20 63 61 73 65 |eans in |the case|
|000019b0| 20 79 6f 75 d5 72 65 20 | 64 65 73 63 72 69 62 69 | you.re |describi|
|000019c0| 6e 67 20 69 73 20 74 68 | 61 74 20 71 75 65 75 65 |ng is th|at queue|
|000019d0| 64 20 72 65 70 6c 69 65 | 73 20 64 6f 20 6e 6f 74 |d replie|s do not|
|000019e0| 20 68 61 70 70 65 6e 20 | 77 68 65 6e 20 79 6f 75 | happen |when you|
|000019f0| 20 61 72 65 20 73 65 6e | 64 69 6e 67 20 74 6f 20 | are sen|ding to |
|00001a00| 79 6f 75 72 73 65 6c 66 | 2e 20 54 68 65 20 41 45 |yourself|. The AE|
|00001a10| 4d 20 77 69 6c 6c 20 64 | 69 72 65 63 74 6c 79 20 |M will d|irectly |
|00001a20| 64 69 73 70 61 74 63 68 | 20 74 6f 20 79 6f 75 72 |dispatch| to your|
|00001a30| 20 27 61 6e 73 72 27 20 | 68 61 6e 64 6c 65 72 2c | 'ansr' |handler,|
|00001a40| 20 74 6f 20 70 72 65 76 | 65 6e 74 20 61 6e 79 20 | to prev|ent any |
|00001a50| 6f 74 68 65 72 20 65 76 | 65 6e 74 73 20 66 72 6f |other ev|ents fro|
|00001a60| 6d 20 62 72 65 61 6b 69 | 6e 67 20 74 68 65 20 63 |m breaki|ng the c|
|00001a70| 68 61 69 6e 20 6f 66 20 | 41 70 70 6c 65 20 65 76 |hain of |Apple ev|
|00001a80| 65 6e 74 73 20 79 6f 75 | 20 6d 61 79 20 62 65 20 |ents you| may be |
|00001a90| 70 72 6f 63 65 73 73 69 | 6e 67 2e 0d 53 6f 20 57 |processi|ng..So W|
|00001aa0| 61 69 74 4e 65 78 74 45 | 76 65 6e 74 20 70 72 6f |aitNextE|vent pro|
|00001ab0| 63 65 73 73 69 6e 67 20 | 6f 66 20 41 70 70 6c 65 |cessing |of Apple|
|00001ac0| 20 65 76 65 6e 74 73 20 | 69 73 20 62 79 70 61 73 | events |is bypas|
|00001ad0| 73 65 64 20 77 68 65 6e | 20 79 6f 75 20 61 72 65 |sed when| you are|
|00001ae0| 20 73 65 6e 64 69 6e 67 | 20 20 65 76 65 6e 74 73 | sending| events|
|00001af0| 20 74 6f 20 79 6f 75 72 | 73 65 6c 66 2e 20 54 68 | to your|self. Th|
|00001b00| 69 73 20 69 73 6e d5 74 | 20 61 20 6d 61 6a 6f 72 |is isn.t| a major|
|00001b10| 20 70 72 6f 62 6c 65 6d | 2c 20 62 75 74 20 69 74 | problem|, but it|
|00001b20| 20 69 73 20 73 6f 6d 65 | 74 68 69 6e 67 20 79 6f | is some|thing yo|
|00001b30| 75 20 6e 65 65 64 20 74 | 6f 20 62 65 20 61 77 61 |u need t|o be awa|
|00001b40| 72 65 20 6f 66 20 69 66 | 20 79 6f 75 20 61 72 65 |re of if| you are|
|00001b50| 20 65 78 70 65 63 74 69 | 6e 67 20 73 6f 6d 65 20 | expecti|ng some |
|00001b60| 6f 74 68 65 72 20 65 76 | 65 6e 74 73 20 74 6f 20 |other ev|ents to |
|00001b70| 62 65 20 70 72 6f 63 65 | 73 73 65 64 20 62 65 66 |be proce|ssed bef|
|00001b80| 6f 72 65 20 79 6f 75 20 | 67 65 74 20 61 20 72 65 |ore you |get a re|
|00001b90| 70 6c 79 20 6f 72 20 6f | 74 68 65 72 20 41 70 70 |ply or o|ther App|
|00001ba0| 6c 65 20 65 76 65 6e 74 | 2e 0d 58 2d 52 65 66 3a |le event|..X-Ref:|
|00001bb0| 0d 4d 61 63 69 6e 74 6f | 73 68 20 54 65 63 68 6e |.Macinto|sh Techn|
|00001bc0| 69 63 61 6c 20 4e 6f 74 | 65 20 d2 47 65 74 74 69 |ical Not|e .Getti|
|00001bd0| 6e 67 20 69 6e 20 54 6f | 75 63 68 20 77 69 74 68 |ng in To|uch with|
|00001be0| 20 59 6f 75 72 73 65 6c | 66 20 76 69 61 20 74 68 | Yoursel|f via th|
|00001bf0| 65 20 41 70 70 6c 65 20 | 45 76 65 6e 74 20 4d 61 |e Apple |Event Ma|
|00001c00| 6e 61 67 65 72 d3 0d 54 | 61 72 67 65 74 20 50 72 |nager..T|arget Pr|
|00001c10| 6f 63 65 73 73 20 6d 75 | 73 74 20 62 65 20 76 61 |ocess mu|st be va|
|00001c20| 6c 69 64 20 61 6e 64 20 | 68 69 67 68 2d 6c 65 76 |lid and |high-lev|
|00001c30| 65 6c 20 65 76 65 6e 74 | 20 61 77 61 72 65 0d 57 |el event| aware.W|
|00001c40| 72 69 74 74 65 6e 3a 09 | 38 2f 31 36 2f 39 31 0d |ritten:.|8/16/91.|
|00001c50| 4c 61 73 74 20 72 65 76 | 69 65 77 65 64 3a 09 38 |Last rev|iewed:.8|
|00001c60| 2f 31 2f 39 32 0d 57 68 | 65 6e 20 49 20 73 65 6e |/1/92.Wh|en I sen|
|00001c70| 64 20 61 6e 20 27 6f 64 | 6f 63 27 20 41 70 70 6c |d an 'od|oc' Appl|
|00001c80| 65 20 65 76 65 6e 74 20 | 74 6f 20 61 6e 20 61 6c |e event |to an al|
|00001c90| 72 65 61 64 79 2d 72 75 | 6e 6e 69 6e 67 20 61 70 |ready-ru|nning ap|
|00001ca0| 70 6c 69 63 61 74 69 6f | 6e 2c 20 49 20 67 65 74 |plicatio|n, I get|
|00001cb0| 20 61 6e 20 2d 36 30 30 | 20 65 72 72 6f 72 20 61 | an -600| error a|
|00001cc0| 74 20 74 68 65 20 41 45 | 53 65 6e 64 20 63 61 6c |t the AE|Send cal|
|00001cd0| 6c 2e 20 54 68 65 20 70 | 72 6f 63 65 73 73 20 73 |l. The p|rocess s|
|00001ce0| 65 72 69 61 6c 20 6e 75 | 6d 62 65 72 20 69 73 20 |erial nu|mber is |
|00001cf0| 63 6f 72 72 65 63 74 20 | 61 74 20 65 6e 74 72 79 |correct |at entry|
|00001d00| 2e 20 57 68 61 74 20 69 | 73 20 74 68 69 73 20 65 |. What i|s this e|
|00001d10| 72 72 6f 72 2c 20 61 6e | 64 20 69 73 20 69 74 20 |rror, an|d is it |
|00001d20| 64 6f 63 75 6d 65 6e 74 | 65 64 20 61 6e 79 77 68 |document|ed anywh|
|00001d30| 65 72 65 3f 0d 5f 5f 5f | 0d 54 68 65 20 65 72 72 |ere?.___|.The err|
|00001d40| 6f 72 20 2d 36 30 30 20 | 6d 65 61 6e 73 20 74 68 |or -600 |means th|
|00001d50| 61 74 20 74 68 65 20 70 | 72 6f 63 65 73 73 20 73 |at the p|rocess s|
|00001d60| 65 72 69 61 6c 20 6e 75 | 6d 62 65 72 20 74 68 61 |erial nu|mber tha|
|00001d70| 74 20 79 6f 75 20 73 65 | 6e 74 20 69 73 20 65 69 |t you se|nt is ei|
|00001d80| 74 68 65 72 20 69 6e 76 | 61 6c 69 64 20 6f 72 20 |ther inv|alid or |
|00001d90| 69 73 20 74 68 65 20 73 | 65 72 69 61 6c 20 6e 75 |is the s|erial nu|
|00001da0| 6d 62 65 72 20 6f 66 20 | 61 20 70 72 6f 63 65 73 |mber of |a proces|
|00001db0| 73 20 74 68 61 74 20 64 | 6f 65 73 20 6e 6f 74 20 |s that d|oes not |
|00001dc0| 61 63 63 65 70 74 20 41 | 70 70 6c 65 20 65 76 65 |accept A|pple eve|
|00001dd0| 6e 74 73 d1 74 68 61 74 | 20 69 73 2c 20 74 68 65 |nts.that| is, the|
|00001de0| 20 68 69 67 68 2d 6c 65 | 76 65 6c 20 65 76 65 6e | high-le|vel even|
|00001df0| 74 20 62 69 74 20 6f 66 | 20 74 68 65 20 64 65 73 |t bit of| the des|
|00001e00| 74 69 6e 61 74 69 6f 6e | 20 70 72 6f 63 65 73 73 |tination| process|
|00001e10| d5 73 20 73 69 7a 65 20 | 72 65 73 6f 75 72 63 65 |.s size |resource|
|00001e20| 20 69 73 6e d5 74 20 73 | 65 74 2e 0d 4c 61 75 6e | isn.t s|et..Laun|
|00001e30| 63 68 41 70 70 6c 69 63 | 61 74 69 6f 6e 20 61 6e |chApplic|ation an|
|00001e40| 64 20 65 76 65 6e 74 20 | 73 65 71 75 65 6e 63 65 |d event |sequence|
|00001e50| 0d 57 72 69 74 74 65 6e | 3a 09 32 2f 31 39 2f 39 |.Written|:.2/19/9|
|00001e60| 32 0d 4c 61 73 74 20 72 | 65 76 69 65 77 65 64 3a |2.Last r|eviewed:|
|00001e70| 09 38 2f 31 2f 39 32 0d | 49 73 20 69 74 20 74 68 |.8/1/92.|Is it th|
|00001e80| 65 20 63 61 73 65 20 74 | 68 61 74 20 69 66 20 49 |e case t|hat if I|
|00001e90| 20 64 6f 75 62 6c 65 2d | 63 6c 69 63 6b 20 61 20 | double-|click a |
|00001ea0| 64 6f 63 75 6d 65 6e 74 | 20 62 65 6c 6f 6e 67 69 |document| belongi|
|00001eb0| 6e 67 20 74 6f 20 6d 79 | 20 61 70 70 6c 69 63 61 |ng to my| applica|
|00001ec0| 74 69 6f 6e 2c 20 74 68 | 65 20 61 70 70 6c 69 63 |tion, th|e applic|
|00001ed0| 61 74 69 6f 6e 20 77 69 | 6c 6c 20 62 65 20 6c 61 |ation wi|ll be la|
|00001ee0| 75 6e 63 68 65 64 20 61 | 6e 64 20 77 69 6c 6c 20 |unched a|nd will |
|00001ef0| 72 65 63 65 69 76 65 20 | 61 6e 20 27 6f 64 6f 63 |receive |an 'odoc|
|00001f00| 27 20 41 70 70 6c 65 20 | 65 76 65 6e 74 2c 20 62 |' Apple |event, b|
|00001f10| 75 74 20 77 69 6c 6c 20 | 6e 6f 74 20 72 65 63 65 |ut will |not rece|
|00001f20| 69 76 65 20 61 6e 20 27 | 6f 61 70 70 27 20 65 76 |ive an '|oapp' ev|
|00001f30| 65 6e 74 d1 74 68 61 74 | 20 69 73 2c 20 69 74 20 |ent.that| is, it |
|00001f40| 77 69 6c 6c 20 72 65 63 | 65 69 76 65 20 65 69 74 |will rec|eive eit|
|00001f50| 68 65 72 20 27 6f 64 6f | 63 27 20 6f 72 20 27 6f |her 'odo|c' or 'o|
|00001f60| 61 70 70 27 20 62 75 74 | 20 6e 6f 74 20 62 6f 74 |app' but| not bot|
|00001f70| 68 3f 0d 5f 5f 5f 0d 59 | 6f 75 d5 72 65 20 63 6f |h?.___.Y|ou.re co|
|00001f80| 72 72 65 63 74 2c 20 65 | 78 63 65 70 74 20 61 63 |rrect, e|xcept ac|
|00001f90| 74 75 61 6c 6c 79 20 69 | 74 20 77 69 6c 6c 20 72 |tually i|t will r|
|00001fa0| 65 63 65 69 76 65 20 6f | 6e 65 20 6f 66 20 27 6f |eceive o|ne of 'o|
|00001fb0| 61 70 70 27 2c 20 27 6f | 64 6f 63 27 2c 20 6f 72 |app', 'o|doc', or|
|00001fc0| 20 27 70 64 6f 63 27 2e | 20 54 68 65 20 27 70 64 | 'pdoc'.| The 'pd|
|00001fd0| 6f 63 27 20 77 69 6c 6c | 20 62 65 20 66 6f 6c 6c |oc' will| be foll|
|00001fe0| 6f 77 65 64 20 28 61 73 | 20 74 68 65 20 6e 65 78 |owed (as| the nex|
|00001ff0| 74 20 65 76 65 6e 74 29 | 20 62 79 20 61 20 27 71 |t event)| by a 'q|
|00002000| 75 69 74 27 20 69 66 20 | 74 68 65 20 27 70 64 6f |uit' if |the 'pdo|
|00002010| 63 27 20 77 61 73 20 74 | 68 65 20 65 76 65 6e 74 |c' was t|he event|
|00002020| 20 73 65 6e 74 20 61 73 | 20 74 68 65 20 61 70 70 | sent as| the app|
|00002030| 6c 69 63 61 74 69 6f 6e | 20 77 61 73 20 6c 61 75 |lication| was lau|
|00002040| 6e 63 68 65 64 2e 0d 54 | 68 69 73 20 69 73 20 74 |nched..T|his is t|
|00002050| 68 65 20 6e 6f 72 6d 61 | 6c 20 73 65 71 75 65 6e |he norma|l sequen|
|00002060| 63 65 20 6f 66 20 65 76 | 65 6e 74 73 2c 20 61 6e |ce of ev|ents, an|
|00002070| 64 20 73 68 6f 75 6c 64 | 20 62 65 20 61 64 68 65 |d should| be adhe|
|00002080| 72 65 64 20 74 6f 20 62 | 79 20 65 76 65 72 79 6f |red to b|y everyo|
|00002090| 6e 65 20 77 68 6f 20 6c | 61 75 6e 63 68 65 73 20 |ne who l|aunches |
|000020a0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 73 2e 20 48 6f |applicat|ions. Ho|
|000020b0| 77 65 76 65 72 2c 20 69 | 74 20 69 73 6e d5 74 20 |wever, i|t isn.t |
|000020c0| 65 6e 66 6f 72 63 65 64 | 20 62 79 20 74 68 65 20 |enforced| by the |
|000020d0| 73 79 73 74 65 6d 20 6f | 72 20 74 68 65 20 46 69 |system o|r the Fi|
|000020e0| 6e 64 65 72 2e 20 49 74 | d5 73 20 70 6f 73 73 69 |nder. It|.s possi|
|000020f0| 62 6c 65 20 66 6f 72 20 | 61 6e 79 20 61 70 70 6c |ble for |any appl|
|00002100| 69 63 61 74 69 6f 6e 20 | 74 6f 20 6c 61 75 6e 63 |ication |to launc|
|00002110| 68 20 79 6f 75 72 20 61 | 70 70 6c 69 63 61 74 69 |h your a|pplicati|
|00002120| 6f 6e 20 77 69 74 68 20 | 61 6e 79 20 65 76 65 6e |on with |any even|
|00002130| 74 2c 20 73 69 6e 63 65 | 20 69 74 20 63 61 6e 20 |t, since| it can |
|00002140| 73 74 75 66 66 20 61 6e | 79 74 68 69 6e 67 20 69 |stuff an|ything i|
|00002150| 6e 20 74 68 65 20 6c 61 | 75 6e 63 68 41 70 70 50 |n the la|unchAppP|
|00002160| 61 72 61 6d 65 74 65 72 | 73 20 66 69 65 6c 64 20 |arameter|s field |
|00002170| 6f 66 20 4c 61 75 6e 63 | 68 41 70 70 6c 69 63 61 |of Launc|hApplica|
|00002180| 74 69 6f 6e 2c 20 61 73 | 20 6c 6f 6e 67 20 61 73 |tion, as| long as|
|00002190| 20 69 74 d5 73 20 61 20 | 76 61 6c 69 64 20 68 69 | it.s a |valid hi|
|000021a0| 67 68 2d 6c 65 76 65 6c | 20 28 6e 6f 74 20 65 76 |gh-level| (not ev|
|000021b0| 65 6e 20 41 70 70 6c 65 | 29 20 65 76 65 6e 74 2e |en Apple|) event.|
|000021c0| 20 4c 61 75 6e 63 68 69 | 6e 67 20 61 6e 6f 74 68 | Launchi|ng anoth|
|000021d0| 65 72 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 74 |er appli|cation t|
|000021e0| 68 69 73 20 77 61 79 20 | 77 6f 75 6c 64 20 62 65 |his way |would be|
|000021f0| 20 62 61 64 20 70 72 6f | 67 72 61 6d 6d 69 6e 67 | bad pro|gramming|
|00002200| 2c 20 61 6e 64 20 77 6f | 75 6c 64 20 62 72 65 61 |, and wo|uld brea|
|00002210| 6b 20 6d 6f 73 74 20 61 | 70 70 6c 69 63 61 74 69 |k most a|pplicati|
|00002220| 6f 6e 73 2c 20 62 75 74 | 20 79 6f 75 20 73 68 6f |ons, but| you sho|
|00002230| 75 6c 64 20 62 65 20 61 | 77 61 72 65 20 74 68 61 |uld be a|ware tha|
|00002240| 74 20 73 6f 6d 65 6f 6e | 65 20 77 68 6f 20 64 6f |t someon|e who do|
|00002250| 65 73 6e d5 74 20 75 6e | 64 65 72 73 74 61 6e 64 |esn.t un|derstand|
|00002260| 20 65 76 65 6e 74 20 68 | 61 6e 64 6c 69 6e 67 20 | event h|andling |
|00002270| 6d 61 79 20 64 6f 20 74 | 68 69 73 20 74 6f 20 79 |may do t|his to y|
|00002280| 6f 75 2e 0d 4e 6f 74 65 | 20 74 68 61 74 20 69 66 |ou..Note| that if|
|00002290| 20 61 6e 6f 74 68 65 72 | 20 61 70 70 6c 69 63 61 | another| applica|
|000022a0| 74 69 6f 6e 20 6c 61 75 | 6e 63 68 65 73 20 79 6f |tion lau|nches yo|
|000022b0| 75 72 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 75 |ur appli|cation u|
|000022c0| 73 69 6e 67 20 4c 61 75 | 6e 63 68 41 70 70 6c 69 |sing Lau|nchAppli|
|000022d0| 63 61 74 69 6f 6e 20 61 | 6e 64 20 64 6f 65 73 6e |cation a|nd doesn|
|000022e0| d5 74 20 73 70 65 63 69 | 66 79 20 61 6e 79 20 68 |.t speci|fy any h|
|000022f0| 69 67 68 2d 6c 65 76 65 | 6c 20 65 76 65 6e 74 20 |igh-leve|l event |
|00002300| 69 6e 20 74 68 65 20 6c | 61 75 6e 63 68 20 70 61 |in the l|aunch pa|
|00002310| 72 61 6d 65 74 65 72 20 | 62 6c 6f 63 6b 2c 20 74 |rameter |block, t|
|00002320| 68 65 20 46 69 6e 64 65 | 72 20 77 69 6c 6c 20 61 |he Finde|r will a|
|00002330| 75 74 6f 6d 61 74 69 63 | 61 6c 6c 79 20 73 75 70 |utomatic|ally sup|
|00002340| 70 6c 79 20 74 68 65 20 | 27 6f 61 70 70 27 20 65 |ply the |'oapp' e|
|00002350| 76 65 6e 74 2e 20 53 6f | 2c 20 69 6e 20 67 65 6e |vent. So|, in gen|
|00002360| 65 72 61 6c 2c 20 69 6e | 20 74 68 65 20 63 6f 72 |eral, in| the cor|
|00002370| 72 65 63 74 20 77 61 79 | 20 74 6f 20 63 6f 64 65 |rect way| to code|
|00002380| 20 41 70 70 6c 65 20 65 | 76 65 6e 74 73 20 61 6e | Apple e|vents an|
|00002390| 64 20 6c 61 75 6e 63 68 | 69 6e 67 2c 20 79 6f 75 |d launch|ing, you|
|000023a0| d5 6c 6c 20 61 6c 77 61 | 79 73 20 72 65 63 65 69 |.ll alwa|ys recei|
|000023b0| 76 65 20 61 6e 20 27 6f | 61 70 70 27 2c 20 27 6f |ve an 'o|app', 'o|
|000023c0| 64 6f 63 27 2c 20 6f 72 | 20 27 70 64 6f 63 27 2e |doc', or| 'pdoc'.|
|000023d0| 0d 49 67 6e 6f 72 69 6e | 67 20 6f 72 20 70 75 72 |.Ignorin|g or pur|
|000023e0| 67 69 6e 67 20 61 6e 20 | 65 76 65 6e 74 20 66 72 |ging an |event fr|
|000023f0| 6f 6d 20 68 69 67 68 2d | 6c 65 76 65 6c 20 65 76 |om high-|level ev|
|00002400| 65 6e 74 20 71 75 65 75 | 65 0d 57 72 69 74 74 65 |ent queu|e.Writte|
|00002410| 6e 3a 09 33 2f 36 2f 39 | 32 0d 4c 61 73 74 20 72 |n:.3/6/9|2.Last r|
|00002420| 65 76 69 65 77 65 64 3a | 09 38 2f 31 2f 39 32 0d |eviewed:|.8/1/92.|
|00002430| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00002440| 20 56 6f 6c 75 6d 65 20 | 56 49 20 73 74 61 74 65 | Volume |VI state|
|00002450| 73 20 74 68 61 74 20 79 | 6f 75 20 63 61 6e 6e 6f |s that y|ou canno|
|00002460| 74 20 75 73 65 20 46 6c | 75 73 68 45 76 65 6e 74 |t use Fl|ushEvent|
|00002470| 73 20 74 6f 20 66 6c 75 | 73 68 20 68 69 67 68 2d |s to flu|sh high-|
|00002480| 6c 65 76 65 6c 20 65 76 | 65 6e 74 73 2e 20 49 20 |level ev|ents. I |
|00002490| 6e 65 65 64 20 74 6f 20 | 66 6c 75 73 68 20 61 20 |need to |flush a |
|000024a0| 73 69 6e 67 6c 65 20 6e | 65 77 46 69 6c 65 20 65 |single n|ewFile e|
|000024b0| 76 65 6e 74 20 66 72 6f | 6d 20 74 68 65 20 68 69 |vent fro|m the hi|
|000024c0| 67 68 2d 6c 65 76 65 6c | 20 65 76 65 6e 74 20 71 |gh-level| event q|
|000024d0| 75 65 75 65 2e 20 48 6f | 77 20 63 61 6e 20 49 20 |ueue. Ho|w can I |
|000024e0| 64 6f 20 74 68 69 73 3f | 0d 5f 5f 5f 0d 54 79 70 |do this?|.___.Typ|
|000024f0| 69 63 61 6c 6c 79 2c 20 | 69 66 20 79 6f 75 20 6e |ically, |if you n|
|00002500| 65 65 64 20 74 6f 20 69 | 67 6e 6f 72 65 20 61 20 |eed to i|gnore a |
|00002510| 70 61 72 74 69 63 75 6c | 61 72 20 65 76 65 6e 74 |particul|ar event|
|00002520| 20 77 68 69 63 68 20 79 | 6f 75 20 77 6f 75 6c 64 | which y|ou would|
|00002530| 20 6f 74 68 65 72 77 69 | 73 65 20 68 61 6e 64 6c | otherwi|se handl|
|00002540| 65 2c 20 79 6f 75 20 63 | 61 6e 20 6a 75 73 74 20 |e, you c|an just |
|00002550| 73 65 74 20 61 20 66 6c | 61 67 20 74 6f 20 74 65 |set a fl|ag to te|
|00002560| 6c 6c 20 74 68 65 20 68 | 61 6e 64 6c 65 72 20 72 |ll the h|andler r|
|00002570| 6f 75 74 69 6e 65 20 6e | 6f 74 20 74 6f 20 74 61 |outine n|ot to ta|
|00002580| 6b 65 20 69 74 73 20 6e | 6f 72 6d 61 6c 20 61 63 |ke its n|ormal ac|
|00002590| 74 69 6f 6e 2e 20 46 6f | 72 20 6d 6f 73 74 20 63 |tion. Fo|r most c|
|000025a0| 69 72 63 75 6d 73 74 61 | 6e 63 65 73 2c 20 74 68 |ircumsta|nces, th|
|000025b0| 69 73 20 69 73 20 74 68 | 65 20 65 61 73 69 65 73 |is is th|e easies|
|000025c0| 74 20 61 6e 64 20 6d 6f | 73 74 20 61 70 70 72 6f |t and mo|st appro|
|000025d0| 70 72 69 61 74 65 20 77 | 61 79 20 74 6f 20 69 67 |priate w|ay to ig|
|000025e0| 6e 6f 72 65 20 61 20 70 | 61 72 74 69 63 75 6c 61 |nore a p|articula|
|000025f0| 72 20 65 76 65 6e 74 2e | 0d 54 68 65 72 65 20 6d |r event.|.There m|
|00002600| 61 79 20 62 65 20 63 69 | 72 63 75 6d 73 74 61 6e |ay be ci|rcumstan|
|00002610| 63 65 73 20 77 68 65 72 | 65 20 79 6f 75 20 6e 65 |ces wher|e you ne|
|00002620| 65 64 20 74 6f 20 70 75 | 72 67 65 20 61 20 73 70 |ed to pu|rge a sp|
|00002630| 65 63 69 66 69 63 20 65 | 76 65 6e 74 20 66 72 6f |ecific e|vent fro|
|00002640| 6d 20 74 68 65 20 68 69 | 67 68 2d 6c 65 76 65 6c |m the hi|gh-level|
|00002650| 20 65 76 65 6e 74 20 71 | 75 65 75 65 2e 20 54 68 | event q|ueue. Th|
|00002660| 61 74 20 63 61 6e 20 62 | 65 20 64 6f 6e 65 20 62 |at can b|e done b|
|00002670| 79 20 73 65 61 72 63 68 | 69 6e 67 20 66 6f 72 20 |y search|ing for |
|00002680| 74 68 65 20 65 76 65 6e | 74 20 77 69 74 68 20 47 |the even|t with G|
|00002690| 65 74 53 70 65 63 69 66 | 69 63 48 69 67 68 4c 65 |etSpecif|icHighLe|
|000026a0| 76 65 6c 45 76 65 6e 74 | 20 61 6e 64 20 61 6e 20 |velEvent| and an |
|000026b0| 61 70 70 72 6f 70 72 69 | 61 74 65 20 66 69 6c 74 |appropri|ate filt|
|000026c0| 65 72 20 70 72 6f 63 3b | 20 69 66 20 74 68 65 20 |er proc;| if the |
|000026d0| 65 76 65 6e 74 20 69 73 | 20 66 6f 75 6e 64 2c 20 |event is| found, |
|000026e0| 6a 75 73 74 20 63 61 6c | 6c 20 41 63 63 65 70 74 |just cal|l Accept|
|000026f0| 48 69 67 68 4c 65 76 65 | 6c 45 76 65 6e 74 20 74 |HighLeve|lEvent t|
|00002700| 6f 20 64 65 71 75 65 75 | 65 20 69 74 2e 20 48 65 |o dequeu|e it. He|
|00002710| 72 65 d5 73 20 61 6e 20 | 65 78 61 6d 70 6c 65 20 |re.s an |example |
|00002720| 77 68 69 63 68 20 72 65 | 6d 6f 76 65 73 20 61 6c |which re|moves al|
|00002730| 6c 20 27 70 64 6f 63 27 | 73 20 66 72 6f 6d 20 74 |l 'pdoc'|s from t|
|00002740| 68 65 20 68 69 67 68 2d | 6c 65 76 65 6c 20 65 76 |he high-|level ev|
|00002750| 65 6e 74 20 71 75 65 75 | 65 3a 0d 54 59 50 45 0d |ent queu|e:.TYPE.|
|00002760| 20 20 45 76 74 43 6c 61 | 73 73 49 44 50 74 72 20 | EvtCla|ssIDPtr |
|00002770| 3d 20 5e 45 76 74 43 6c | 61 73 73 49 44 3b 0d 20 |= ^EvtCl|assID;. |
|00002780| 20 45 76 74 43 6c 61 73 | 73 49 44 20 3d 20 52 45 | EvtClas|sID = RE|
|00002790| 43 4f 52 44 0d 20 20 20 | 20 63 6c 61 73 73 3a 20 |CORD. | class: |
|000027a0| 4f 53 54 79 70 65 3b 0d | 20 20 20 20 65 76 74 49 |OSType;.| evtI|
|000027b0| 44 3a 20 4f 53 54 79 70 | 65 3b 0d 20 20 45 4e 44 |D: OSTyp|e;. END|
|000027c0| 3b 0d 56 41 52 0d 20 20 | 74 68 65 45 76 74 43 6c |;.VAR. |theEvtCl|
|000027d0| 61 73 73 49 44 3a 20 45 | 76 74 43 6c 61 73 73 49 |assID: E|vtClassI|
|000027e0| 44 3b 0d 20 20 72 65 74 | 43 6f 64 65 3a 20 4f 53 |D;. ret|Code: OS|
|000027f0| 45 72 72 3b 0d 20 20 67 | 6f 74 48 4c 45 46 6c 61 |Err;. g|otHLEFla|
|00002800| 67 3a 20 42 6f 6f 6c 65 | 61 6e 3b 0d 20 20 46 55 |g: Boole|an;. FU|
|00002810| 4e 43 54 49 4f 4e 20 4d | 79 47 53 48 4c 45 46 69 |NCTION M|yGSHLEFi|
|00002820| 6c 74 65 72 28 6d 79 44 | 61 74 61 50 74 72 3a 20 |lter(myD|ataPtr: |
|00002830| 50 74 72 3b 20 6d 73 67 | 48 4c 45 4d 50 74 72 3a |Ptr; msg|HLEMPtr:|
|00002840| 20 48 69 67 68 4c 65 76 | 65 6c 45 76 65 6e 74 4d | HighLev|elEventM|
|00002850| 73 67 50 74 72 3b 0d 20 | 20 20 20 73 65 6e 64 65 |sgPtr;. | sende|
|00002860| 72 3a 20 54 61 72 67 65 | 74 49 44 29 3a 20 42 4f |r: Targe|tID): BO|
|00002870| 4f 4c 45 41 4e 3b 0d 20 | 20 56 41 52 0d 20 20 20 |OLEAN;. | VAR. |
|00002880| 20 6d 79 54 61 72 67 3a | 20 54 61 72 67 65 74 49 | myTarg:| TargetI|
|00002890| 44 3b 0d 20 20 20 20 6d | 79 52 65 66 43 6f 6e 3a |D;. m|yRefCon:|
|000028a0| 20 4c 6f 6e 67 49 6e 74 | 3b 0d 20 20 20 20 6d 79 | LongInt|;. my|
|000028b0| 42 75 66 66 3a 20 50 74 | 72 3b 0d 20 20 20 20 6d |Buff: Pt|r;. m|
|000028c0| 79 4c 65 6e 3a 20 4c 6f | 6e 67 49 6e 74 3b 0d 20 |yLen: Lo|ngInt;. |
|000028d0| 20 20 20 6d 79 45 72 72 | 3a 20 4f 53 45 72 72 3b | myErr|: OSErr;|
|000028e0| 0d 20 20 42 45 47 49 4e | 0d 20 20 20 20 4d 79 47 |. BEGIN|. MyG|
|000028f0| 53 48 4c 45 46 69 6c 74 | 65 72 20 3a 3d 20 46 41 |SHLEFilt|er := FA|
|00002900| 4c 53 45 3b 0d 20 20 20 | 20 49 46 20 28 4f 53 54 |LSE;. | IF (OST|
|00002910| 79 70 65 28 6d 73 67 48 | 4c 45 4d 50 74 72 5e 2e |ype(msgH|LEMPtr^.|
|00002920| 74 68 65 4d 73 67 45 76 | 65 6e 74 2e 6d 65 73 73 |theMsgEv|ent.mess|
|00002930| 61 67 65 29 20 3d 20 0d | 20 20 20 20 20 20 20 20 |age) = .| |
|00002940| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002950| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 45 76 | | Ev|
|00002960| 74 43 6c 61 73 73 49 44 | 50 74 72 28 6d 79 44 61 |tClassID|Ptr(myDa|
|00002970| 74 61 50 74 72 29 5e 2e | 63 6c 61 73 73 29 20 41 |taPtr)^.|class) A|
|00002980| 4e 44 0d 20 20 20 20 20 | 20 28 4f 53 54 79 70 65 |ND. | (OSType|
|00002990| 28 6d 73 67 48 4c 45 4d | 50 74 72 5e 2e 74 68 65 |(msgHLEM|Ptr^.the|
|000029a0| 4d 73 67 45 76 65 6e 74 | 2e 77 68 65 72 65 29 20 |MsgEvent|.where) |
|000029b0| 3d 20 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |= . | |
|000029c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000029d0| 20 20 20 20 20 20 20 20 | 20 45 76 74 43 6c 61 73 | | EvtClas|
|000029e0| 73 49 44 50 74 72 28 6d | 79 44 61 74 61 50 74 72 |sIDPtr(m|yDataPtr|
|000029f0| 29 5e 2e 65 76 74 49 44 | 29 20 54 48 45 4e 0d 20 |)^.evtID|) THEN. |
|00002a00| 20 20 20 20 20 42 45 47 | 49 4e 0d 20 20 20 20 20 | BEG|IN. |
|00002a10| 20 20 20 6d 79 4c 65 6e | 20 3a 3d 20 30 3b 0d 20 | myLen| := 0;. |
|00002a20| 20 20 20 20 20 20 20 6d | 79 42 75 66 66 20 3a 3d | m|yBuff :=|
|00002a30| 20 4e 49 4c 3b 0d 20 20 | 20 20 20 20 20 0d 20 20 | NIL;. | . |
|00002a40| 20 20 20 20 20 20 6d 79 | 45 72 72 20 3a 3d 20 41 | my|Err := A|
|00002a50| 63 63 65 70 74 48 69 67 | 68 4c 65 76 65 6c 45 76 |cceptHig|hLevelEv|
|00002a60| 65 6e 74 28 6d 79 54 61 | 72 67 2c 20 6d 79 52 65 |ent(myTa|rg, myRe|
|00002a70| 66 43 6f 6e 2c 20 6d 79 | 42 75 66 66 2c 20 6d 79 |fCon, my|Buff, my|
|00002a80| 4c 65 6e 29 3b 0d 20 20 | 20 20 20 20 20 20 49 46 |Len);. | IF|
|00002a90| 20 6d 79 45 72 72 20 3d | 20 62 75 66 66 65 72 49 | myErr =| bufferI|
|00002aa0| 73 53 6d 61 6c 6c 20 54 | 48 45 4e 0d 20 20 20 20 |sSmall T|HEN. |
|00002ab0| 20 20 20 20 42 45 47 49 | 4e 0d 20 20 20 20 20 20 | BEGI|N. |
|00002ac0| 20 20 20 20 6d 79 42 75 | 66 66 20 3a 3d 20 4e 65 | myBu|ff := Ne|
|00002ad0| 77 50 74 72 28 6d 79 4c | 65 6e 29 3b 0d 20 20 20 |wPtr(myL|en);. |
|00002ae0| 20 20 20 20 20 20 20 6d | 79 45 72 72 20 3a 3d 20 | m|yErr := |
|00002af0| 41 63 63 65 70 74 48 69 | 67 68 4c 65 76 65 6c 45 |AcceptHi|ghLevelE|
|00002b00| 76 65 6e 74 28 6d 79 54 | 61 72 67 2c 20 6d 79 52 |vent(myT|arg, myR|
|00002b10| 65 66 43 6f 6e 2c 20 6d | 79 42 75 66 66 2c 20 6d |efCon, m|yBuff, m|
|00002b20| 79 4c 65 6e 29 3b 0d 20 | 20 20 20 20 20 20 20 45 |yLen);. | E|
|00002b30| 4e 44 3b 0d 20 20 20 20 | 20 20 20 20 49 46 20 6d |ND;. | IF m|
|00002b40| 79 45 72 72 20 3c 3e 20 | 6e 6f 45 72 72 20 54 48 |yErr <> |noErr TH|
|00002b50| 45 4e 20 48 61 6e 64 6c | 65 45 72 72 6f 72 28 6d |EN Handl|eError(m|
|00002b60| 79 45 72 72 29 3b 0d 20 | 20 20 20 20 20 20 20 49 |yErr);. | I|
|00002b70| 46 20 6d 79 42 75 66 66 | 20 3c 3e 20 4e 49 4c 20 |F myBuff| <> NIL |
|00002b80| 54 48 45 4e 20 44 69 73 | 70 6f 73 65 50 74 72 28 |THEN Dis|posePtr(|
|00002b90| 6d 79 42 75 66 66 29 3b | 0d 20 20 20 20 20 20 20 |myBuff);|. |
|00002ba0| 20 4d 79 47 53 48 4c 45 | 46 69 6c 74 65 72 20 3a | MyGSHLE|Filter :|
|00002bb0| 3d 20 54 52 55 45 3b 0d | 20 20 20 20 20 20 45 4e |= TRUE;.| EN|
|00002bc0| 44 3b 0d 20 20 45 4e 44 | 3b 0d 2e 2e 2e 0d 42 45 |D;. END|;.....BE|
|00002bd0| 47 49 4e 20 20 20 20 20 | 7b 20 6d 61 69 6e 20 7d |GIN |{ main }|
|00002be0| 0d 20 20 2e 2e 2e 0d 20 | 20 7b 20 70 75 72 67 65 |. .... | { purge|
|00002bf0| 20 61 6c 6c 20 70 72 69 | 6e 74 20 64 6f 63 20 41 | all pri|nt doc A|
|00002c00| 70 70 6c 65 20 65 76 65 | 6e 74 73 20 66 72 6f 6d |pple eve|nts from|
|00002c10| 20 74 68 65 20 48 4c 45 | 20 71 75 65 75 65 20 7d | the HLE| queue }|
|00002c20| 0d 20 20 74 68 65 45 76 | 74 43 6c 61 73 73 49 44 |. theEv|tClassID|
|00002c30| 2e 63 6c 61 73 73 20 3a | 3d 20 6b 43 6f 72 65 45 |.class :|= kCoreE|
|00002c40| 76 65 6e 74 43 6c 61 73 | 73 3b 0d 20 20 74 68 65 |ventClas|s;. the|
|00002c50| 45 76 74 43 6c 61 73 73 | 49 44 2e 65 76 74 49 44 |EvtClass|ID.evtID|
|00002c60| 20 3a 3d 20 6b 41 45 50 | 72 69 6e 74 44 6f 63 75 | := kAEP|rintDocu|
|00002c70| 6d 65 6e 74 73 3b 0d 20 | 20 52 45 50 45 41 54 0d |ments;. | REPEAT.|
|00002c80| 20 20 20 20 67 6f 74 48 | 4c 45 46 6c 61 67 20 3a | gotH|LEFlag :|
|00002c90| 3d 20 47 65 74 53 70 65 | 63 69 66 69 63 48 69 67 |= GetSpe|cificHig|
|00002ca0| 68 4c 65 76 65 6c 45 76 | 65 6e 74 28 40 4d 79 47 |hLevelEv|ent(@MyG|
|00002cb0| 53 48 4c 45 46 69 6c 74 | 65 72 2c 20 0d 20 20 20 |SHLEFilt|er, . |
|00002cc0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002cd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ce0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002cf0| 40 74 68 65 45 76 74 43 | 6c 61 73 73 49 44 2c 20 |@theEvtC|lassID, |
|00002d00| 72 65 74 43 6f 64 65 29 | 0d 20 20 55 4e 54 49 4c |retCode)|. UNTIL|
|00002d10| 20 28 4e 4f 54 20 67 6f | 74 48 4c 45 46 6c 61 67 | (NOT go|tHLEFlag|
|00002d20| 29 20 4f 52 20 28 72 65 | 74 43 6f 64 65 20 3c 3e |) OR (re|tCode <>|
|00002d30| 20 6e 6f 45 72 72 29 3b | 0d 20 20 2e 2e 2e 0d 45 | noErr);|. ....E|
|00002d40| 4e 44 2e 0d 47 65 74 53 | 70 65 63 69 66 69 63 48 |ND..GetS|pecificH|
|00002d50| 69 67 68 4c 65 76 65 6c | 45 76 65 6e 74 20 69 73 |ighLevel|Event is|
|00002d60| 20 64 6f 63 75 6d 65 6e | 74 65 64 20 69 6e 20 43 | documen|ted in C|
|00002d70| 68 61 70 74 65 72 20 35 | 20 6f 66 20 49 6e 73 69 |hapter 5| of Insi|
|00002d80| 64 65 20 4d 61 63 69 6e | 74 6f 73 68 20 56 6f 6c |de Macin|tosh Vol|
|00002d90| 75 6d 65 20 56 49 2e 0d | 41 70 70 6c 65 20 45 76 |ume VI..|Apple Ev|
|00002da0| 65 6e 74 20 68 61 6e 64 | 6c 65 72 3a 20 49 6e 73 |ent hand|ler: Ins|
|00002db0| 74 61 6c 6c 61 74 69 6f | 6e 20 63 6f 64 65 0d 57 |tallatio|n code.W|
|00002dc0| 72 69 74 74 65 6e 3a 09 | 39 2f 31 30 2f 39 31 0d |ritten:.|9/10/91.|
|00002dd0| 4c 61 73 74 20 72 65 76 | 69 65 77 65 64 3a 09 38 |Last rev|iewed:.8|
|00002de0| 2f 31 2f 39 32 0d 49 d5 | 6d 20 77 72 69 74 69 6e |/1/92.I.|m writin|
|00002df0| 67 20 61 20 73 6d 61 6c | 6c 20 61 70 70 6c 69 63 |g a smal|l applic|
|00002e00| 61 74 69 6f 6e 20 74 68 | 61 74 20 75 73 65 73 20 |ation th|at uses |
|00002e10| 41 70 70 6c 65 20 65 76 | 65 6e 74 73 2c 20 77 68 |Apple ev|ents, wh|
|00002e20| 69 63 68 20 6e 65 69 74 | 68 65 72 20 6f 70 65 6e |ich neit|her open|
|00002e30| 73 20 64 6f 63 75 6d 65 | 6e 74 73 20 6e 6f 72 20 |s docume|nts nor |
|00002e40| 70 72 69 6e 74 73 2e 20 | 49 6e 73 69 64 65 20 4d |prints. |Inside M|
|00002e50| 61 63 69 6e 74 6f 73 68 | 20 56 6f 6c 75 6d 65 20 |acintosh| Volume |
|00002e60| 56 49 20 73 61 79 73 20 | 74 68 61 74 20 61 6c 6c |VI says |that all|
|00002e70| 20 41 70 70 6c 65 20 65 | 76 65 6e 74 2d 61 77 61 | Apple e|vent-awa|
|00002e80| 72 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 73 20 |re appli|cations |
|00002e90| 73 68 6f 75 6c 64 20 73 | 75 70 70 6f 72 74 20 74 |should s|upport t|
|00002ea0| 68 65 20 6f 64 6f 63 20 | 61 6e 64 20 70 64 6f 63 |he odoc |and pdoc|
|00002eb0| 20 41 70 70 6c 65 20 65 | 76 65 6e 74 73 2c 20 62 | Apple e|vents, b|
|00002ec0| 75 74 20 74 68 65 73 65 | 20 61 72 65 20 6e 6f 74 |ut these| are not|
|00002ed0| 20 61 70 70 72 6f 70 72 | 69 61 74 65 20 69 6e 20 | appropr|iate in |
|00002ee0| 6d 79 20 63 61 73 65 2e | 20 57 68 61 74 20 73 68 |my case.| What sh|
|00002ef0| 6f 75 6c 64 20 49 20 64 | 6f 3f 0d 5f 5f 5f 0d 59 |ould I d|o?.___.Y|
|00002f00| 6f 75 20 64 6f 6e d5 74 | 20 6e 65 63 65 73 73 61 |ou don.t| necessa|
|00002f10| 72 69 6c 79 20 6e 65 65 | 64 20 74 6f 20 69 6e 73 |rily nee|d to ins|
|00002f20| 74 61 6c 6c 20 61 20 68 | 61 6e 64 6c 65 72 20 66 |tall a h|andler f|
|00002f30| 6f 72 20 65 61 63 68 20 | 65 76 65 6e 74 2c 20 62 |or each |event, b|
|00002f40| 75 74 20 69 74 20 6d 61 | 6b 65 73 20 79 6f 75 72 |ut it ma|kes your|
|00002f50| 20 63 6f 64 65 20 63 6c | 65 61 6e 65 72 2e 20 49 | code cl|eaner. I|
|00002f60| 66 20 79 6f 75 20 64 6f | 6e d5 74 20 68 61 76 65 |f you do|n.t have|
|00002f70| 20 61 20 68 61 6e 64 6c | 65 72 2c 20 74 68 65 20 | a handl|er, the |
|00002f80| 41 70 70 6c 65 20 45 76 | 65 6e 74 20 4d 61 6e 61 |Apple Ev|ent Mana|
|00002f90| 67 65 72 20 77 69 6c 6c | 20 61 75 74 6f 6d 61 74 |ger will| automat|
|00002fa0| 69 63 61 6c 6c 79 20 72 | 65 74 75 72 6e 20 65 72 |ically r|eturn er|
|00002fb0| 72 41 45 45 76 65 6e 74 | 4e 6f 74 48 61 6e 64 6c |rAEEvent|NotHandl|
|00002fc0| 65 64 20 66 72 6f 6d 20 | 79 6f 75 72 20 41 45 50 |ed from |your AEP|
|00002fd0| 72 6f 63 65 73 73 41 70 | 70 6c 65 45 76 65 6e 74 |rocessAp|pleEvent|
|00002fe0| 20 63 61 6c 6c 2c 20 73 | 69 6e 63 65 20 69 74 20 | call, s|ince it |
|00002ff0| 63 61 6e d5 74 20 66 69 | 6e 64 20 61 20 68 61 6e |can.t fi|nd a han|
|00003000| 64 6c 65 72 20 66 6f 72 | 20 74 68 65 20 65 76 65 |dler for| the eve|
|00003010| 6e 74 20 69 6e 20 74 68 | 65 20 68 61 6e 64 6c 65 |nt in th|e handle|
|00003020| 72 20 74 61 62 6c 65 73 | 2e 20 42 75 74 20 77 65 |r tables|. But we|
|00003030| 20 72 65 63 6f 6d 6d 65 | 6e 64 20 69 6e 73 74 61 | recomme|nd insta|
|00003040| 6c 6c 69 6e 67 20 68 61 | 6e 64 6c 65 72 73 20 66 |lling ha|ndlers f|
|00003050| 6f 72 20 74 68 65 20 72 | 65 71 75 69 72 65 64 20 |or the r|equired |
|00003060| 41 70 70 6c 65 20 65 76 | 65 6e 74 73 20 61 6e 79 |Apple ev|ents any|
|00003070| 77 61 79 3b 20 69 74 20 | 6d 61 6b 65 73 20 79 6f |way; it |makes yo|
|00003080| 75 72 20 63 6f 64 65 20 | 63 6c 65 61 6e 65 72 20 |ur code |cleaner |
|00003090| 61 6e 64 20 65 61 73 69 | 65 72 20 74 6f 20 75 6e |and easi|er to un|
|000030a0| 64 65 72 73 74 61 6e 64 | 2c 20 61 73 20 77 65 6c |derstand|, as wel|
|000030b0| 6c 20 61 73 20 65 61 73 | 69 6c 79 20 61 6c 6c 6f |l as eas|ily allo|
|000030c0| 77 69 6e 67 20 79 6f 75 | 20 61 20 70 6c 61 63 65 |wing you| a place|
|000030d0| 20 74 6f 20 70 75 74 20 | 61 20 72 6f 75 74 69 6e | to put |a routin|
|000030e0| 65 20 77 68 65 6e 20 79 | 6f 75 20 6e 65 65 64 20 |e when y|ou need |
|000030f0| 74 6f 20 69 6d 70 6c 65 | 6d 65 6e 74 20 69 74 2e |to imple|ment it.|
|00003100| 20 41 6e 64 20 69 74 20 | 64 6f 65 73 6e d5 74 20 | And it |doesn.t |
|00003110| 74 61 6b 65 20 75 70 20 | 6d 75 63 68 20 6d 65 6d |take up |much mem|
|00003120| 6f 72 79 2e 20 4a 75 73 | 74 20 69 6e 73 74 61 6c |ory. Jus|t instal|
|00003130| 6c 20 61 20 68 61 6e 64 | 6c 65 72 20 6c 69 6b 65 |l a hand|ler like|
|00003140| 20 74 68 69 73 20 28 69 | 6e 20 4d 50 57 20 43 29 | this (i|n MPW C)|
|00003150| 3a 0d 70 61 73 63 61 6c | 20 4f 53 45 72 72 20 41 |:.pascal| OSErr A|
|00003160| 45 50 72 69 6e 74 48 61 | 6e 64 6c 65 72 28 41 70 |EPrintHa|ndler(Ap|
|00003170| 70 6c 65 45 76 65 6e 74 | 20 2a 6d 65 73 73 61 67 |pleEvent| *messag|
|00003180| 65 69 6e 2c 0d 41 70 70 | 6c 65 45 76 65 6e 74 20 |ein,.App|leEvent |
|00003190| 2a 72 65 70 6c 79 2c 20 | 6c 6f 6e 67 20 72 65 66 |*reply, |long ref|
|000031a0| 43 6f 6e 49 6e 29 0d 7b | 0d 2f 2a 20 54 65 6c 6c |ConIn).{|./* Tell|
|000031b0| 20 74 68 65 20 63 6f 6d | 70 69 6c 65 72 20 49 27 | the com|piler I'|
|000031c0| 6d 20 6e 6f 74 20 75 73 | 69 6e 67 20 74 68 65 73 |m not us|ing thes|
|000031d0| 65 20 70 61 72 61 6d 65 | 74 65 72 73 20 2a 2f 0d |e parame|ters */.|
|000031e0| 23 70 72 61 67 6d 61 20 | 75 6e 75 73 65 64 20 28 |#pragma |unused (|
|000031f0| 72 65 70 6c 79 2c 72 65 | 66 43 6f 6e 49 6e 2c 6d |reply,re|fConIn,m|
|00003200| 65 73 73 61 67 65 69 6e | 29 0d 20 20 20 20 72 65 |essagein|). re|
|00003210| 74 75 72 6e 28 65 72 72 | 41 45 45 76 65 6e 74 4e |turn(err|AEEventN|
|00003220| 6f 74 48 61 6e 64 6c 65 | 64 29 3b 20 20 2f 2a 20 |otHandle|d); /* |
|00003230| 61 6e 64 20 72 65 74 75 | 72 6e 20 6d 79 20 65 72 |and retu|rn my er|
|00003240| 72 6f 72 20 2a 2f 0d 7d | 0d 46 69 6e 64 69 6e 67 |ror */.}|.Finding|
|00003250| 20 41 70 70 6c 65 20 65 | 76 65 6e 74 20 73 65 6e | Apple e|vent sen|
|00003260| 64 65 72 d5 73 20 74 61 | 72 67 65 74 20 49 44 20 |der.s ta|rget ID |
|00003270| 6f 72 20 70 72 6f 63 65 | 73 73 20 73 65 72 69 61 |or proce|ss seria|
|00003280| 6c 20 6e 75 6d 62 65 72 | 0d 57 72 69 74 74 65 6e |l number|.Written|
|00003290| 3a 09 31 30 2f 32 35 2f | 39 31 0d 4c 61 73 74 20 |:.10/25/|91.Last |
|000032a0| 72 65 76 69 65 77 65 64 | 3a 09 38 2f 31 2f 39 32 |reviewed|:.8/1/92|
|000032b0| 0d 48 6f 77 20 63 61 6e | 20 49 20 69 64 65 6e 74 |.How can| I ident|
|000032c0| 69 66 79 20 74 68 65 20 | 73 65 6e 64 65 72 20 6f |ify the |sender o|
|000032d0| 66 20 61 6e 20 41 70 70 | 6c 65 20 65 76 65 6e 74 |f an App|le event|
|000032e0| 3f 0d 5f 5f 5f 0d 49 66 | 20 79 6f 75 72 20 61 70 |?.___.If| your ap|
|000032f0| 70 6c 69 63 61 74 69 6f | 6e 20 69 73 20 6a 75 73 |plicatio|n is jus|
|00003300| 74 20 73 65 6e 64 69 6e | 67 20 61 20 72 65 70 6c |t sendin|g a repl|
|00003310| 79 2c 20 69 74 20 73 68 | 6f 75 6c 64 20 6e 6f 74 |y, it sh|ould not|
|00003320| 20 62 65 20 63 72 65 61 | 74 69 6e 67 20 61 6e 20 | be crea|ting an |
|00003330| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 6f 72 20 63 |Apple ev|ent or c|
|00003340| 61 6c 6c 69 6e 67 20 41 | 45 53 65 6e 64 2e 20 49 |alling A|ESend. I|
|00003350| 6e 73 74 65 61 64 2c 20 | 69 74 20 73 68 6f 75 6c |nstead, |it shoul|
|00003360| 64 20 73 74 75 66 66 20 | 74 68 65 20 72 65 73 70 |d stuff |the resp|
|00003370| 6f 6e 73 65 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |onse inf|ormation|
|00003380| 20 69 6e 74 6f 20 74 68 | 65 20 72 65 70 6c 79 20 | into th|e reply |
|00003390| 65 76 65 6e 74 20 69 6e | 20 74 68 65 20 41 70 70 |event in| the App|
|000033a0| 6c 65 20 65 76 65 6e 74 | 20 68 61 6e 64 6c 65 72 |le event| handler|
|000033b0| 2c 20 61 73 20 73 68 6f | 77 6e 20 6f 6e 20 70 61 |, as sho|wn on pa|
|000033c0| 67 65 20 36 2d 35 30 20 | 6f 66 20 49 6e 73 69 64 |ge 6-50 |of Insid|
|000033d0| 65 20 4d 61 63 69 6e 74 | 6f 73 68 20 56 6f 6c 75 |e Macint|osh Volu|
|000033e0| 6d 65 20 56 49 2e 20 54 | 68 65 20 41 70 70 6c 65 |me VI. T|he Apple|
|000033f0| 20 45 76 65 6e 74 20 4d | 61 6e 61 67 65 72 20 74 | Event M|anager t|
|00003400| 61 6b 65 73 20 63 61 72 | 65 20 6f 66 20 61 64 64 |akes car|e of add|
|00003410| 72 65 73 73 69 6e 67 20 | 61 6e 64 20 73 65 6e 64 |ressing |and send|
|00003420| 69 6e 67 20 74 68 65 20 | 65 76 65 6e 74 2e 0d 54 |ing the |event..T|
|00003430| 6f 20 66 69 6e 64 20 74 | 68 65 20 74 61 72 67 65 |o find t|he targe|
|00003440| 74 20 49 44 20 6f 72 20 | 70 72 6f 63 65 73 73 20 |t ID or |process |
|00003450| 73 65 72 69 61 6c 20 6e | 75 6d 62 65 72 20 6f 66 |serial n|umber of|
|00003460| 20 74 68 65 20 73 65 6e | 64 65 72 20 6f 66 20 61 | the sen|der of a|
|00003470| 6e 20 41 70 70 6c 65 20 | 45 76 65 6e 74 2c 20 75 |n Apple |Event, u|
|00003480| 73 65 20 41 45 47 65 74 | 41 74 74 72 69 62 75 74 |se AEGet|Attribut|
|00003490| 65 50 74 72 20 74 6f 20 | 65 78 74 72 61 63 74 20 |ePtr to |extract |
|000034a0| 74 68 65 20 61 64 64 72 | 65 73 73 20 61 74 74 72 |the addr|ess attr|
|000034b0| 69 62 75 74 65 2c 20 61 | 73 20 66 6f 6c 6c 6f 77 |ibute, a|s follow|
|000034c0| 73 3a 0d 72 65 74 43 6f | 64 65 20 3a 3d 20 41 45 |s:.retCo|de := AE|
|000034d0| 47 65 74 41 74 74 72 69 | 62 75 74 65 50 74 72 28 |GetAttri|butePtr(|
|000034e0| 6d 79 41 70 70 6c 65 45 | 76 65 6e 74 2c 20 6b 65 |myAppleE|vent, ke|
|000034f0| 79 41 64 64 72 65 73 73 | 41 74 74 72 2c 20 0d 20 |yAddress|Attr, . |
|00003500| 20 74 79 70 65 57 69 6c | 64 43 61 72 64 2c 20 73 | typeWil|dCard, s|
|00003510| 65 6e 64 65 72 54 79 70 | 65 2c 20 40 73 65 6e 64 |enderTyp|e, @send|
|00003520| 65 72 42 75 66 66 65 72 | 2c 20 73 69 7a 65 6f 66 |erBuffer|, sizeof|
|00003530| 28 73 65 6e 64 65 72 42 | 75 66 66 65 72 29 2c 20 |(senderB|uffer), |
|00003540| 0d 20 20 73 65 6e 64 65 | 72 53 69 7a 65 29 0d 54 |. sende|rSize).T|
|00003550| 68 65 20 73 65 6e 64 65 | 72 42 75 66 66 65 72 20 |he sende|rBuffer |
|00003560| 63 61 6e 20 6c 61 74 65 | 72 20 62 65 20 75 73 65 |can late|r be use|
|00003570| 64 20 77 69 74 68 20 41 | 45 43 72 65 61 74 65 44 |d with A|ECreateD|
|00003580| 65 73 63 20 74 6f 20 63 | 72 65 61 74 65 20 61 6e |esc to c|reate an|
|00003590| 20 61 64 64 72 65 73 73 | 20 74 6f 20 62 65 20 70 | address| to be p|
|000035a0| 61 73 73 65 64 20 74 6f | 20 41 45 53 65 6e 64 2e |assed to| AESend.|
|000035b0| 20 54 68 65 20 62 75 66 | 66 65 72 20 73 68 6f 75 | The buf|fer shou|
|000035c0| 6c 64 20 62 65 20 61 74 | 20 6c 65 61 73 74 20 61 |ld be at| least a|
|000035d0| 73 20 6c 61 72 67 65 20 | 61 73 20 64 61 74 61 20 |s large |as data |
|000035e0| 74 79 70 65 20 54 61 72 | 67 65 74 49 44 2e 20 53 |type Tar|getID. S|
|000035f0| 65 65 20 49 6e 73 69 64 | 65 20 4d 61 63 69 6e 74 |ee Insid|e Macint|
|00003600| 6f 73 68 20 56 6f 6c 75 | 6d 65 20 56 49 2c 20 70 |osh Volu|me VI, p|
|00003610| 61 67 65 20 35 2d 32 32 | 2c 20 66 6f 72 20 61 20 |age 5-22|, for a |
|00003620| 64 65 73 63 72 69 70 74 | 69 6f 6e 20 6f 66 20 54 |descript|ion of T|
|00003630| 61 72 67 65 74 49 44 2e | 0d 4c 61 75 6e 63 68 69 |argetID.|.Launchi|
|00003640| 6e 67 20 61 6e 20 61 70 | 70 6c 69 63 61 74 69 6f |ng an ap|plicatio|
|00003650| 6e 20 72 65 6d 6f 74 65 | 6c 79 0d 57 72 69 74 74 |n remote|ly.Writt|
|00003660| 65 6e 3a 09 34 2f 31 36 | 2f 39 32 0d 4c 61 73 74 |en:.4/16|/92.Last|
|00003670| 20 72 65 76 69 65 77 65 | 64 3a 09 35 2f 32 31 2f | reviewe|d:.5/21/|
|00003680| 39 32 0d 49 20 6e 65 65 | 64 20 74 6f 20 6c 61 75 |92.I nee|d to lau|
|00003690| 6e 63 68 20 61 6e 20 61 | 70 70 6c 69 63 61 74 69 |nch an a|pplicati|
|000036a0| 6f 6e 20 72 65 6d 6f 74 | 65 6c 79 2e 20 49 20 68 |on remot|ely. I h|
|000036b0| 61 76 65 20 41 70 70 6c | 65 20 65 76 65 6e 74 20 |ave Appl|e event |
|000036c0| 63 6c 69 65 6e 74 20 63 | 6f 64 65 20 77 68 69 63 |client c|ode whic|
|000036d0| 68 20 6e 65 65 64 73 20 | 74 6f 20 73 74 61 72 74 |h needs |to start|
|000036e0| 20 75 70 20 74 68 65 20 | 73 65 72 76 65 72 20 69 | up the |server i|
|000036f0| 66 20 69 74 20 69 73 20 | 6e 6f 74 20 61 6c 72 65 |f it is |not alre|
|00003700| 61 64 79 20 65 78 65 63 | 75 74 69 6e 67 2e 20 48 |ady exec|uting. H|
|00003710| 6f 77 20 64 6f 20 49 20 | 64 6f 20 74 68 69 73 3f |ow do I |do this?|
|00003720| 20 54 68 65 20 50 72 6f | 63 65 73 73 20 4d 61 6e | The Pro|cess Man|
|00003730| 61 67 65 72 20 64 6f 65 | 73 6e d5 74 20 73 65 65 |ager doe|sn.t see|
|00003740| 6d 20 74 6f 20 62 65 20 | 61 62 6c 65 20 74 6f 20 |m to be |able to |
|00003750| 6c 61 75 6e 63 68 20 61 | 6e 20 61 70 70 6c 69 63 |launch a|n applic|
|00003760| 61 74 69 6f 6e 20 6f 6e | 20 61 6e 6f 74 68 65 72 |ation on| another|
|00003770| 20 6d 61 63 68 69 6e 65 | 20 61 6e 64 20 74 68 65 | machine| and the|
|00003780| 20 46 69 6e 64 65 72 20 | 53 75 69 74 65 20 64 6f | Finder |Suite do|
|00003790| 65 73 20 6e 6f 74 20 68 | 61 76 65 20 61 20 4c 61 |es not h|ave a La|
|000037a0| 75 6e 63 68 20 41 70 70 | 6c 65 20 45 76 65 6e 74 |unch App|le Event|
|000037b0| 2e 0d 5f 5f 5f 0d 57 68 | 61 74 20 79 6f 75 20 6e |..___.Wh|at you n|
|000037c0| 65 65 64 20 74 6f 20 64 | 6f 20 74 68 69 73 20 69 |eed to d|o this i|
|000037d0| 73 20 74 6f 20 75 73 65 | 20 74 68 65 20 4f 70 65 |s to use| the Ope|
|000037e0| 6e 53 65 6c 65 63 74 69 | 6f 6e 20 46 69 6e 64 65 |nSelecti|on Finde|
|000037f0| 72 20 65 76 65 6e 74 2e | 20 53 65 6e 64 20 61 6e |r event.| Send an|
|00003800| 20 4f 70 65 6e 53 65 6c | 65 63 74 69 6f 6e 20 74 | OpenSel|ection t|
|00003810| 6f 20 74 68 65 20 46 69 | 6e 64 65 72 20 77 68 69 |o the Fi|nder whi|
|00003820| 63 68 20 69 73 20 72 75 | 6e 6e 69 6e 67 20 6f 6e |ch is ru|nning on|
|00003830| 20 74 68 65 20 6d 61 63 | 68 69 6e 65 20 79 6f 75 | the mac|hine you|
|00003840| 20 77 61 6e 74 20 74 6f | 20 6c 61 75 6e 63 68 20 | want to| launch |
|00003850| 74 68 65 20 6f 74 68 65 | 72 20 61 70 70 6c 69 63 |the othe|r applic|
|00003860| 61 74 69 6f 6e 2c 20 61 | 6e 64 20 74 68 65 20 46 |ation, a|nd the F|
|00003870| 69 6e 64 65 72 20 77 69 | 6c 6c 20 72 65 73 6f 6c |inder wi|ll resol|
|00003880| 76 65 20 74 68 65 20 4f | 70 65 6e 53 65 6c 65 63 |ve the O|penSelec|
|00003890| 74 69 6f 6e 20 69 6e 74 | 6f 20 61 20 6c 61 75 6e |tion int|o a laun|
|000038a0| 63 68 20 6f 66 20 74 68 | 65 20 61 70 70 6c 69 63 |ch of th|e applic|
|000038b0| 61 74 69 6f 6e 2e 20 41 | 73 20 79 6f 75 20 63 61 |ation. A|s you ca|
|000038c0| 6e 20 73 65 65 20 69 66 | 20 79 6f 75 20 67 6c 61 |n see if| you gla|
|000038d0| 6e 63 65 20 61 74 20 74 | 68 65 20 4f 70 65 6e 53 |nce at t|he OpenS|
|000038e0| 65 6c 63 74 69 6f 6e 20 | 65 76 65 6e 74 20 69 6e |elction |event in|
|000038f0| 20 74 68 65 20 72 65 67 | 69 73 74 72 79 2c 20 74 | the reg|istry, t|
|00003900| 68 65 72 65 20 69 73 20 | 6f 6e 65 20 64 69 66 66 |here is |one diff|
|00003910| 69 63 75 6c 74 79 20 77 | 69 74 68 20 75 73 69 6e |iculty w|ith usin|
|00003920| 67 20 69 74 20 66 6f 72 | 20 72 65 6d 6f 74 65 20 |g it for| remote |
|00003930| 6c 61 75 6e 63 68 69 6e | 67 2e 20 59 6f 75 20 68 |launchin|g. You h|
|00003940| 61 76 65 20 74 6f 20 70 | 61 73 73 20 61 6e 20 61 |ave to p|ass an a|
|00003950| 6c 69 61 73 20 74 6f 20 | 74 68 65 20 61 70 70 6c |lias to |the appl|
|00003960| 69 63 61 74 69 6f 6e 20 | 79 6f 75 20 77 61 6e 74 |ication |you want|
|00003970| 20 74 6f 20 6c 61 75 6e | 63 68 2e 20 49 66 20 74 | to laun|ch. If t|
|00003980| 68 65 20 6d 61 63 68 69 | 6e 65 20 79 6f 75 20 77 |he machi|ne you w|
|00003990| 69 73 68 20 74 6f 20 6c | 61 75 6e 63 68 20 74 68 |ish to l|aunch th|
|000039a0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 6f 6e |e applic|ation on|
|000039b0| 20 69 73 20 61 6c 72 65 | 61 64 79 20 6d 6f 75 6e | is alre|ady moun|
|000039c0| 74 65 64 20 61 73 20 61 | 20 66 69 6c 65 20 73 65 |ted as a| file se|
|000039d0| 72 76 65 72 2c 20 74 68 | 69 73 20 69 73 6e d5 74 |rver, th|is isn.t|
|000039e0| 20 69 6d 70 6f 72 74 61 | 6e 74 2c 20 73 69 6e 63 | importa|nt, sinc|
|000039f0| 65 20 79 6f 75 20 63 61 | 6e 20 63 72 65 61 74 65 |e you ca|n create|
|00003a00| 20 61 6e 20 61 6c 69 61 | 73 20 74 6f 20 74 68 61 | an alia|s to tha|
|00003a10| 74 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 72 69 |t applic|ation ri|
|00003a20| 67 68 74 20 61 74 20 74 | 68 61 74 20 6d 6f 6d 65 |ght at t|hat mome|
|00003a30| 6e 74 2e 20 4f 72 2c 20 | 69 66 20 79 6f 75 20 68 |nt. Or, |if you h|
|00003a40| 61 76 65 20 63 6f 6e 6e | 65 63 74 65 64 20 69 6e |ave conn|ected in|
|00003a50| 20 74 68 65 20 70 61 73 | 74 20 28 75 73 69 6e 67 | the pas|t (using|
|00003a60| 20 74 68 61 74 20 6d 61 | 63 68 69 6e 65 20 61 73 | that ma|chine as|
|00003a70| 20 61 20 73 65 72 76 65 | 72 29 20 79 6f 75 20 63 | a serve|r) you c|
|00003a80| 61 6e 20 75 73 65 20 61 | 20 70 72 65 76 69 6f 75 |an use a| previou|
|00003a90| 73 6c 79 20 63 72 65 61 | 74 65 64 20 61 6c 69 61 |sly crea|ted alia|
|00003aa0| 73 20 61 6e 64 20 79 6f | 75 20 77 69 6c 6c 20 6a |s and yo|u will j|
|00003ab0| 75 73 74 20 62 65 20 70 | 72 6f 6d 70 74 65 64 20 |ust be p|rompted |
|00003ac0| 74 6f 20 6c 6f 67 20 6f | 6e 20 74 6f 20 74 68 65 |to log o|n to the|
|00003ad0| 20 73 65 72 76 65 72 20 | 61 74 20 6c 61 75 6e 63 | server |at launc|
|00003ae0| 68 20 74 69 6d 65 2e 0d | 48 6f 77 65 76 65 72 2c |h time..|However,|
|00003af0| 20 69 66 20 79 6f 75 20 | 77 61 6e 74 20 74 6f 20 | if you |want to |
|00003b00| 6c 61 75 6e 63 68 20 61 | 20 66 69 6c 65 20 77 69 |launch a| file wi|
|00003b10| 74 68 6f 75 74 20 6c 6f | 67 67 69 6e 67 20 6f 6e |thout lo|gging on|
|00003b20| 20 74 6f 20 74 68 65 20 | 6f 74 68 65 72 20 6d 61 | to the |other ma|
|00003b30| 63 68 69 6e 65 20 61 73 | 20 61 20 73 65 72 76 65 |chine as| a serve|
|00003b40| 72 2c 20 79 6f 75 d5 6c | 6c 20 6e 65 65 64 20 74 |r, you.l|l need t|
|00003b50| 6f 20 75 73 65 20 74 68 | 65 20 4e 65 77 41 6c 69 |o use th|e NewAli|
|00003b60| 61 73 4d 69 6e 69 6d 61 | 6c 46 72 6f 6d 46 75 6c |asMinima|lFromFul|
|00003b70| 6c 50 61 74 68 20 63 61 | 6c 6c 20 69 6e 20 74 68 |lPath ca|ll in th|
|00003b80| 65 20 41 6c 69 61 73 20 | 4d 61 6e 61 67 65 72 2e |e Alias |Manager.|
|00003b90| 20 57 69 74 68 20 74 68 | 69 73 2c 20 79 6f 75 d5 | With th|is, you.|
|00003ba0| 6c 6c 20 70 61 73 73 20 | 74 68 65 20 66 75 6c 6c |ll pass |the full|
|00003bb0| 20 70 61 74 68 20 6e 61 | 6d 65 20 6f 66 20 74 68 | path na|me of th|
|00003bc0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 6f 6e |e applic|ation on|
|00003bd0| 20 74 68 65 20 6f 74 68 | 65 72 20 6d 61 63 68 69 | the oth|er machi|
|00003be0| 6e 65 20 79 6f 75 20 77 | 69 73 68 20 74 6f 20 6c |ne you w|ish to l|
|00003bf0| 61 75 6e 63 68 2c 20 61 | 6e 64 20 74 68 65 20 41 |aunch, a|nd the A|
|00003c00| 6c 69 61 73 20 4d 61 6e | 61 67 65 72 20 77 69 6c |lias Man|ager wil|
|00003c10| 6c 20 6d 61 6b 65 20 61 | 6e 20 61 6c 69 61 73 20 |l make a|n alias |
|00003c20| 74 6f 20 69 74 20 69 6e | 20 74 68 65 20 73 61 6d |to it in| the sam|
|00003c30| 65 20 77 61 79 20 69 74 | 20 64 6f 65 73 20 66 6f |e way it| does fo|
|00003c40| 72 20 75 6e 6d 6f 75 6e | 74 65 64 20 76 6f 6c 75 |r unmoun|ted volu|
|00003c50| 6d 65 73 2e 20 54 68 65 | 20 6f 62 76 69 6f 75 73 |mes. The| obvious|
|00003c60| 20 64 72 61 77 62 61 63 | 6b 20 68 65 72 65 20 69 | drawbac|k here i|
|00003c70| 73 20 74 68 61 74 20 79 | 6f 75 d5 6c 6c 20 6e 65 |s that y|ou.ll ne|
|00003c80| 65 64 20 74 6f 20 6b 6e | 6f 77 20 74 68 65 20 66 |ed to kn|ow the f|
|00003c90| 75 6c 6c 20 70 61 74 68 | 6e 61 6d 65 20 6f 66 20 |ull path|name of |
|00003ca0| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 2c |the appl|ication,|
|00003cb0| 20 62 75 74 20 74 68 65 | 72 65 d5 73 20 61 20 70 | but the|re.s a p|
|00003cc0| 72 69 63 65 20 74 6f 20 | 70 61 79 20 66 6f 72 20 |rice to |pay for |
|00003cd0| 65 76 65 72 79 74 68 69 | 6e 67 2e 20 54 68 65 20 |everythi|ng. The |
|00003ce0| 46 69 6e 64 65 72 4f 70 | 65 6e 53 65 6c 20 73 61 |FinderOp|enSel sa|
|00003cf0| 6d 70 6c 65 20 63 6f 64 | 65 20 6f 6e 20 74 68 65 |mple cod|e on the|
|00003d00| 20 44 65 76 65 6c 6f 70 | 65 72 20 43 44 20 73 68 | Develop|er CD sh|
|00003d10| 6f 77 73 20 74 68 65 20 | 4e 65 77 41 6c 69 61 73 |ows the |NewAlias|
|00003d20| 4d 69 6e 69 6d 61 6c 46 | 72 6f 6d 46 75 6c 6c 50 |MinimalF|romFullP|
|00003d30| 61 74 68 20 6d 65 74 68 | 6f 64 2e 0d 4f 70 65 6e |ath meth|od..Open|
|00003d40| 69 6e 67 20 64 6f 63 75 | 6d 65 6e 74 73 20 66 72 |ing docu|ments fr|
|00003d50| 6f 6d 20 61 6e 6f 74 68 | 65 72 20 61 70 70 6c 69 |om anoth|er appli|
|00003d60| 63 61 74 69 6f 6e 0d 57 | 72 69 74 74 65 6e 3a 09 |cation.W|ritten:.|
|00003d70| 35 2f 32 2f 39 31 0d 4c | 61 73 74 20 72 65 76 69 |5/2/91.L|ast revi|
|00003d80| 65 77 65 64 3a 09 38 2f | 31 2f 39 32 0d 48 6f 77 |ewed:.8/|1/92.How|
|00003d90| 20 63 61 6e 20 49 20 6f | 70 65 6e 20 4d 61 63 69 | can I o|pen Maci|
|00003da0| 6e 74 6f 73 68 20 64 6f | 63 75 6d 65 6e 74 73 20 |ntosh do|cuments |
|00003db0| 74 68 61 74 20 62 65 6c | 6f 6e 67 20 74 6f 20 61 |that bel|ong to a|
|00003dc0| 6e 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 74 68 |n applic|ation th|
|00003dd0| 61 74 d5 73 20 61 6c 72 | 65 61 64 79 20 72 75 6e |at.s alr|eady run|
|00003de0| 6e 69 6e 67 3f 0d 5f 5f | 5f 0d 49 66 20 79 6f 75 |ning?.__|_.If you|
|00003df0| 20 66 69 6e 64 20 74 68 | 61 74 20 79 6f 75 20 68 | find th|at you h|
|00003e00| 61 76 65 20 74 68 65 20 | 41 70 70 6c 65 20 45 76 |ave the |Apple Ev|
|00003e10| 65 6e 74 20 4d 61 6e 61 | 67 65 72 20 70 72 65 73 |ent Mana|ger pres|
|00003e20| 65 6e 74 2c 20 74 68 65 | 6e 20 62 75 69 6c 64 20 |ent, the|n build |
|00003e30| 27 6f 64 6f 63 27 20 41 | 70 70 6c 65 20 65 76 65 |'odoc' A|pple eve|
|00003e40| 6e 74 73 20 74 6f 20 79 | 6f 75 72 20 68 65 61 72 |nts to y|our hear|
|00003e50| 74 d5 73 20 63 6f 6e 74 | 65 6e 74 2c 20 61 6e 64 |t.s cont|ent, and|
|00003e60| 20 73 65 6e 64 20 74 68 | 65 6d 20 74 6f 20 77 68 | send th|em to wh|
|00003e70| 6f 6d 65 76 65 72 20 79 | 6f 75 20 77 69 73 68 2e |omever y|ou wish.|
|00003e80| 20 54 68 65 20 50 72 6f | 63 65 73 73 20 4d 61 6e | The Pro|cess Man|
|00003e90| 61 67 65 72 20 77 69 6c | 6c 20 68 6f 70 20 69 6e |ager wil|l hop in|
|00003ea0| 20 74 68 65 72 65 20 69 | 66 20 74 68 65 20 74 61 | there i|f the ta|
|00003eb0| 72 67 65 74 20 69 73 6e | d5 74 20 41 70 70 6c 65 |rget isn|.t Apple|
|00003ec0| 20 65 76 65 6e 74 2d 61 | 77 61 72 65 20 61 6e 64 | event-a|ware and|
|00003ed0| 20 63 6f 65 72 63 65 20 | 74 68 65 20 72 65 71 75 | coerce |the requ|
|00003ee0| 69 72 65 64 20 41 70 70 | 6c 65 20 65 76 65 6e 74 |ired App|le event|
|00003ef0| 20 74 6f 20 74 68 65 20 | 61 70 70 72 6f 70 72 69 | to the |appropri|
|00003f00| 61 74 65 20 50 75 70 70 | 65 74 20 53 74 72 69 6e |ate Pupp|et Strin|
|00003f10| 67 20 66 6f 72 20 79 6f | 75 2e 20 4e 6f 20 66 75 |g for yo|u. No fu|
|00003f20| 72 74 68 65 72 20 68 61 | 63 6b 73 20 6f 6e 20 79 |rther ha|cks on y|
|00003f30| 6f 75 72 20 70 61 72 74 | 20 61 72 65 20 72 65 71 |our part| are req|
|00003f40| 75 69 72 65 64 2e 20 59 | 6f 75 20 6c 69 74 65 72 |uired. Y|ou liter|
|00003f50| 61 6c 6c 79 20 64 6f 6e | d5 74 20 63 61 72 65 20 |ally don|.t care |
|00003f60| 28 61 74 20 6c 65 61 73 | 74 20 66 6f 72 20 74 68 |(at leas|t for th|
|00003f70| 65 20 70 75 72 70 6f 73 | 65 73 20 6f 66 20 74 68 |e purpos|es of th|
|00003f80| 65 20 72 65 71 75 69 72 | 65 64 20 41 70 70 6c 65 |e requir|ed Apple|
|00003f90| 20 65 76 65 6e 74 73 29 | 20 77 68 65 74 68 65 72 | events)| whether|
|00003fa0| 20 79 6f 75 72 20 74 61 | 72 67 65 74 20 69 73 20 | your ta|rget is |
|00003fb0| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 61 77 61 72 |Apple ev|ent awar|
|00003fc0| 65 20 6f 72 20 6e 6f 74 | 2e 0d 41 6c 65 72 74 20 |e or not|..Alert |
|00003fd0| 75 73 65 72 20 69 6e 73 | 74 65 61 64 20 6f 66 20 |user ins|tead of |
|00003fe0| 73 65 6e 64 69 6e 67 20 | 27 71 75 69 74 27 20 41 |sending |'quit' A|
|00003ff0| 70 70 6c 65 20 65 76 65 | 6e 74 20 74 6f 20 66 72 |pple eve|nt to fr|
|00004000| 65 65 20 52 41 4d 0d 57 | 72 69 74 74 65 6e 3a 09 |ee RAM.W|ritten:.|
|00004010| 35 2f 32 2f 39 31 0d 4c | 61 73 74 20 72 65 76 69 |5/2/91.L|ast revi|
|00004020| 65 77 65 64 3a 09 38 2f | 31 2f 39 32 0d 49 73 20 |ewed:.8/|1/92.Is |
|00004030| 69 74 20 61 63 63 65 70 | 74 61 62 6c 65 20 74 6f |it accep|table to|
|00004040| 20 66 6f 72 63 65 20 6f | 74 68 65 72 20 4d 61 63 | force o|ther Mac|
|00004050| 69 6e 74 6f 73 68 20 61 | 70 70 6c 69 63 61 74 69 |intosh a|pplicati|
|00004060| 6f 6e 73 20 74 6f 20 71 | 75 69 74 20 74 6f 20 66 |ons to q|uit to f|
|00004070| 72 65 65 20 75 70 20 6d | 65 6d 6f 72 79 3f 0d 5f |ree up m|emory?._|
|00004080| 5f 5f 0d 57 68 69 6c 65 | 20 69 74 d5 73 20 70 6f |__.While| it.s po|
|00004090| 73 73 69 62 6c 65 20 74 | 6f 20 66 72 65 65 20 75 |ssible t|o free u|
|000040a0| 70 20 6d 65 6d 6f 72 79 | 20 62 79 20 73 65 6e 64 |p memory| by send|
|000040b0| 69 6e 67 20 61 20 27 71 | 75 69 74 27 20 41 70 70 |ing a 'q|uit' App|
|000040c0| 6c 65 20 65 76 65 6e 74 | 2c 20 61 20 6d 75 63 68 |le event|, a much|
|000040d0| 20 62 65 74 74 65 72 20 | 61 6c 74 65 72 6e 61 74 | better |alternat|
|000040e0| 69 76 65 20 66 72 6f 6d | 20 61 20 68 75 6d 61 6e |ive from| a human|
|000040f0| 20 69 6e 74 65 72 66 61 | 63 65 20 73 74 61 6e 64 | interfa|ce stand|
|00004100| 70 6f 69 6e 74 20 69 73 | 20 74 6f 20 70 6f 73 65 |point is| to pose|
|00004110| 20 61 6e 20 61 6c 65 72 | 74 20 74 6f 20 74 68 65 | an aler|t to the|
|00004120| 20 75 73 65 72 20 69 6e | 64 69 63 61 74 69 6e 67 | user in|dicating|
|00004130| 20 74 68 61 74 20 79 6f | 75 20 63 6f 75 6c 64 6e | that yo|u couldn|
|00004140| d5 74 20 6f 70 65 6e 20 | 74 68 65 20 64 6f 63 75 |.t open |the docu|
|00004150| 6d 65 6e 74 73 20 74 68 | 65 79 20 72 65 71 75 65 |ments th|ey reque|
|00004160| 73 74 65 64 20 64 75 65 | 20 74 6f 20 61 20 6c 61 |sted due| to a la|
|00004170| 63 6b 20 6f 66 20 6d 65 | 6d 6f 72 79 2c 20 61 6e |ck of me|mory, an|
|00004180| 64 20 61 73 6b 69 6e 67 | 20 74 68 65 20 75 73 65 |d asking| the use|
|00004190| 72 20 74 6f 20 70 6c 65 | 61 73 65 20 74 72 79 20 |r to ple|ase try |
|000041a0| 71 75 69 74 74 69 6e 67 | 20 73 6f 6d 65 20 6f 74 |quitting| some ot|
|000041b0| 68 65 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |her appl|ications|
|000041c0| 20 61 6e 64 20 74 72 79 | 20 61 67 61 69 6e 2e 20 | and try| again. |
|000041d0| 49 74 d5 73 20 62 65 74 | 74 65 72 20 74 6f 20 6c |It.s bet|ter to l|
|000041e0| 65 61 76 65 20 74 68 65 | 20 75 73 65 72 20 69 6e |eave the| user in|
|000041f0| 20 63 6f 6e 74 72 6f 6c | 20 6f 66 20 74 68 65 20 | control| of the |
|00004200| 70 72 6f 63 65 73 73 2e | 0d 53 65 6e 64 69 6e 67 |process.|.Sending|
|00004210| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 6d 75 | applica|tions mu|
|00004220| 73 74 20 62 65 20 68 69 | 67 68 2d 6c 65 76 65 6c |st be hi|gh-level|
|00004230| 20 65 76 65 6e 74 20 61 | 77 61 72 65 0d 57 72 69 | event a|ware.Wri|
|00004240| 74 74 65 6e 3a 09 37 2f | 33 30 2f 39 32 0d 4c 61 |tten:.7/|30/92.La|
|00004250| 73 74 20 72 65 76 69 65 | 77 65 64 3a 09 37 2f 33 |st revie|wed:.7/3|
|00004260| 30 2f 39 32 0d 57 68 79 | 20 64 6f 20 49 20 67 65 |0/92.Why| do I ge|
|00004270| 74 20 65 72 72 6f 72 20 | 2d 39 30 33 20 28 61 20 |t error |-903 (a |
|00004280| 50 50 43 20 54 6f 6f 6c | 62 6f 78 20 6e 6f 50 6f |PPC Tool|box noPo|
|00004290| 72 74 45 72 72 29 20 77 | 68 65 6e 20 49 20 73 65 |rtErr) w|hen I se|
|000042a0| 6e 64 20 61 6e 20 41 70 | 70 6c 65 20 65 76 65 6e |nd an Ap|ple even|
|000042b0| 74 20 74 6f 20 61 20 72 | 75 6e 6e 69 6e 67 20 61 |t to a r|unning a|
|000042c0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 77 69 74 68 20 |pplicati|on with |
|000042d0| 41 45 53 65 6e 64 3f 0d | 5f 5f 5f 0d 54 68 65 20 |AESend?.|___.The |
|000042e0| 68 69 67 68 2d 6c 65 76 | 65 6c 20 65 76 65 6e 74 |high-lev|el event|
|000042f0| 20 61 77 61 72 65 20 62 | 69 74 20 6f 66 20 74 68 | aware b|it of th|
|00004300| 65 20 73 65 6e 64 69 6e | 67 20 61 70 70 6c 69 63 |e sendin|g applic|
|00004310| 61 74 69 6f 6e d5 73 20 | 53 49 5a 45 20 2d 31 20 |ation.s |SIZE -1 |
|00004320| 72 65 73 6f 75 72 63 65 | 20 28 61 6e 64 20 53 49 |resource| (and SI|
|00004330| 5a 45 20 30 20 72 65 73 | 6f 75 72 63 65 2c 20 69 |ZE 0 res|ource, i|
|00004340| 66 20 61 6e 79 29 20 6d | 75 73 74 20 62 65 20 73 |f any) m|ust be s|
|00004350| 65 74 2e 0d 48 69 67 68 | 2d 6c 65 76 65 6c 20 4d |et..High|-level M|
|00004360| 61 63 69 6e 74 6f 73 68 | 20 65 76 65 6e 74 73 20 |acintosh| events |
|00004370| 61 6e 64 20 75 73 65 72 | 20 72 65 66 65 72 65 6e |and user| referen|
|00004380| 63 65 20 6e 75 6d 62 65 | 72 73 0d 57 72 69 74 74 |ce numbe|rs.Writt|
|00004390| 65 6e 3a 09 34 2f 32 34 | 2f 39 32 0d 4c 61 73 74 |en:.4/24|/92.Last|
|000043a0| 20 72 65 76 69 65 77 65 | 64 3a 09 37 2f 31 33 2f | reviewe|d:.7/13/|
|000043b0| 39 32 0d 57 65 20 61 72 | 65 20 75 73 69 6e 67 20 |92.We ar|e using |
|000043c0| 41 70 70 6c 65 20 65 76 | 65 6e 74 73 20 77 69 74 |Apple ev|ents wit|
|000043d0| 68 20 74 68 65 20 50 72 | 6f 67 72 61 6d 2d 74 6f |h the Pr|ogram-to|
|000043e0| 2d 50 72 6f 67 72 61 6d | 20 43 6f 6d 6d 75 6e 69 |-Program| Communi|
|000043f0| 63 61 74 69 6f 6e 73 20 | 28 50 50 43 29 20 54 6f |cations |(PPC) To|
|00004400| 6f 6c 62 6f 78 2e 20 57 | 65 20 63 61 6c 6c 20 53 |olbox. W|e call S|
|00004410| 74 61 72 74 53 65 63 75 | 72 65 53 65 73 73 69 6f |tartSecu|reSessio|
|00004420| 6e 20 61 66 74 65 72 20 | 50 50 43 42 72 6f 77 73 |n after |PPCBrows|
|00004430| 65 72 20 74 6f 20 61 75 | 74 68 65 6e 74 69 63 61 |er to au|thentica|
|00004440| 74 65 20 74 68 65 20 75 | 73 65 72 d5 73 20 69 64 |te the u|ser.s id|
|00004450| 65 6e 74 69 74 79 2e 20 | 54 68 65 20 75 73 65 72 |entity. |The user|
|00004460| 20 69 64 65 6e 74 69 74 | 79 20 64 69 61 6c 6f 67 | identit|y dialog|
|00004470| 20 62 6f 78 20 69 73 20 | 64 69 73 70 6c 61 79 65 | box is |displaye|
|00004480| 64 20 61 6e 64 20 65 76 | 65 72 79 74 68 69 6e 67 |d and ev|erything|
|00004490| 20 6c 6f 6f 6b 73 20 67 | 6f 6f 64 2e 20 48 6f 77 | looks g|ood. How|
|000044a0| 65 76 65 72 2c 20 69 6e | 20 74 68 65 20 66 69 72 |ever, in| the fir|
|000044b0| 73 74 20 41 45 53 65 6e | 64 20 63 61 6c 6c 20 77 |st AESen|d call w|
|000044c0| 65 20 6d 61 6b 65 2c 20 | 74 68 65 20 75 73 65 72 |e make, |the user|
|000044d0| 20 69 64 65 6e 74 69 74 | 79 20 64 69 61 6c 6f 67 | identit|y dialog|
|000044e0| 20 69 73 20 64 69 73 70 | 6c 61 79 65 64 20 61 67 | is disp|layed ag|
|000044f0| 61 69 6e 2e 20 54 68 65 | 20 75 73 65 72 20 69 64 |ain. The| user id|
|00004500| 65 6e 74 69 74 79 20 64 | 69 61 6c 6f 67 20 69 73 |entity d|ialog is|
|00004510| 20 6e 6f 74 20 62 65 20 | 64 69 73 70 6c 61 79 65 | not be |displaye|
|00004520| 64 20 61 66 74 65 72 20 | 74 68 61 74 2e 20 57 68 |d after |that. Wh|
|00004530| 79 20 69 73 20 74 68 69 | 73 20 64 69 61 6c 6f 67 |y is thi|s dialog|
|00004540| 20 69 73 20 62 65 69 6e | 67 20 64 69 73 70 6c 61 | is bein|g displa|
|00004550| 79 65 64 20 66 72 6f 6d | 20 41 45 53 65 6e 64 20 |yed from| AESend |
|00004560| 77 68 65 6e 20 49 d5 76 | 65 20 61 6c 72 65 61 64 |when I.v|e alread|
|00004570| 79 20 61 75 74 68 65 6e | 74 69 63 61 74 65 64 20 |y authen|ticated |
|00004580| 74 68 65 20 75 73 65 72 | 20 69 64 65 6e 74 69 74 |the user| identit|
|00004590| 79 20 77 69 74 68 20 53 | 74 61 72 74 53 65 63 75 |y with S|tartSecu|
|000045a0| 72 65 53 65 73 73 69 6f | 6e 3f 0d 5f 5f 5f 0d 46 |reSessio|n?.___.F|
|000045b0| 69 72 73 74 20 61 20 66 | 65 77 20 50 50 43 20 66 |irst a f|ew PPC f|
|000045c0| 61 63 74 73 3a 0d 31 2e | 20 57 68 65 6e 20 61 20 |acts:.1.| When a |
|000045d0| 50 50 43 20 73 65 73 73 | 69 6f 6e 20 69 73 20 73 |PPC sess|ion is s|
|000045e0| 74 61 72 74 65 64 2c 20 | 53 74 61 72 74 53 65 63 |tarted, |StartSec|
|000045f0| 75 72 65 53 65 73 73 69 | 6f 6e 20 6c 65 74 73 20 |ureSessi|on lets |
|00004600| 74 68 65 20 75 73 65 72 | 20 61 75 74 68 65 6e 74 |the user| authent|
|00004610| 69 63 61 74 65 20 74 68 | 65 20 73 65 73 73 69 6f |icate th|e sessio|
|00004620| 6e 20 28 69 66 20 74 68 | 65 20 73 65 73 73 69 6f |n (if th|e sessio|
|00004630| 6e 20 69 73 20 77 69 74 | 68 20 61 20 70 72 6f 67 |n is wit|h a prog|
|00004640| 72 61 6d 20 6f 6e 20 61 | 6e 6f 74 68 65 72 20 4d |ram on a|nother M|
|00004650| 61 63 69 6e 74 6f 73 68 | 29 20 61 6e 64 20 72 65 |acintosh|) and re|
|00004660| 74 75 72 6e 73 20 61 20 | 75 73 65 72 20 72 65 66 |turns a |user ref|
|00004670| 65 72 65 6e 63 65 20 6e | 75 6d 62 65 72 20 66 6f |erence n|umber fo|
|00004680| 72 20 74 68 61 74 20 63 | 6f 6e 6e 65 63 74 69 6f |r that c|onnectio|
|00004690| 6e 20 69 6e 20 74 68 65 | 20 75 73 65 72 52 65 66 |n in the| userRef|
|000046a0| 4e 75 6d 20 66 69 65 6c | 64 20 6f 66 20 74 68 65 |Num fiel|d of the|
|000046b0| 20 50 50 43 53 74 61 72 | 74 50 42 52 65 63 2e 20 | PPCStar|tPBRec. |
|000046c0| 54 68 61 74 20 75 73 65 | 72 20 72 65 66 65 72 65 |That use|r refere|
|000046d0| 6e 63 65 20 6e 75 6d 62 | 65 72 20 63 61 6e 20 62 |nce numb|er can b|
|000046e0| 65 20 75 73 65 64 20 74 | 6f 20 73 74 61 72 74 20 |e used t|o start |
|000046f0| 61 6e 6f 74 68 65 72 20 | 63 6f 6e 6e 65 63 74 69 |another |connecti|
|00004700| 6f 6e 20 28 75 73 69 6e | 67 20 50 50 43 53 74 61 |on (usin|g PPCSta|
|00004710| 72 74 20 69 6e 73 74 65 | 61 64 20 6f 66 20 53 74 |rt inste|ad of St|
|00004720| 61 72 74 53 65 63 75 72 | 65 53 65 73 73 69 6f 6e |artSecur|eSession|
|00004730| 29 20 77 69 74 68 20 74 | 68 65 20 73 61 6d 65 20 |) with t|he same |
|00004740| 72 65 6d 6f 74 65 20 4d | 61 63 69 6e 74 6f 73 68 |remote M|acintosh|
|00004750| 20 62 79 70 61 73 73 69 | 6e 67 20 74 68 65 20 61 | bypassi|ng the a|
|00004760| 75 74 68 65 6e 74 69 63 | 61 74 69 6f 6e 20 64 69 |uthentic|ation di|
|00004770| 61 6c 6f 67 73 2e 0d 32 | 2e 20 55 73 65 72 20 72 |alogs..2|. User r|
|00004780| 65 66 65 72 65 6e 63 65 | 20 6e 75 6d 62 65 72 73 |eference| numbers|
|00004790| 20 61 72 65 20 76 61 6c | 69 64 20 75 6e 74 69 6c | are val|id until|
|000047a0| 20 65 69 74 68 65 72 20 | 74 68 65 79 20 61 72 65 | either |they are|
|000047b0| 20 64 65 6c 65 74 65 64 | 20 77 69 74 68 20 74 68 | deleted| with th|
|000047c0| 65 20 44 65 6c 65 74 65 | 55 73 65 72 49 64 65 6e |e Delete|UserIden|
|000047d0| 74 69 74 79 20 66 75 6e | 63 74 69 6f 6e 2c 20 6f |tity fun|ction, o|
|000047e0| 72 20 6f 6e 65 20 6f 66 | 20 74 68 65 20 4d 61 63 |r one of| the Mac|
|000047f0| 69 6e 74 6f 73 68 20 73 | 79 73 74 65 6d 73 20 69 |intosh s|ystems i|
|00004800| 73 20 72 65 73 74 61 72 | 74 65 64 2e 0d 33 2e 20 |s restar|ted..3. |
|00004810| 49 66 20 74 68 65 20 6e | 61 6d 65 20 61 6e 64 20 |If the n|ame and |
|00004820| 70 61 73 73 77 6f 72 64 | 20 63 6f 6d 62 69 6e 61 |password| combina|
|00004830| 74 69 6f 6e 20 75 73 65 | 64 20 74 6f 20 73 74 61 |tion use|d to sta|
|00004840| 72 74 20 61 20 73 65 73 | 73 69 6f 6e 20 69 73 20 |rt a ses|sion is |
|00004850| 74 68 65 20 73 61 6d 65 | 20 61 73 20 74 68 65 20 |the same| as the |
|00004860| 6f 77 6e 65 72 20 6f 66 | 20 74 68 65 20 4d 61 63 |owner of| the Mac|
|00004870| 69 6e 74 6f 73 68 20 74 | 68 65 20 75 73 65 72 20 |intosh t|he user |
|00004880| 69 73 20 75 73 69 6e 67 | 2c 20 74 68 65 6e 20 74 |is using|, then t|
|00004890| 68 65 20 75 73 65 72 20 | 72 65 66 65 72 65 6e 63 |he user |referenc|
|000048a0| 65 20 6e 75 6d 62 65 72 | 20 72 65 74 75 72 6e 65 |e number| returne|
|000048b0| 64 20 72 65 66 65 72 73 | 20 74 6f 20 74 68 65 20 |d refers| to the |
|000048c0| 64 65 66 61 75 6c 74 20 | 75 73 65 72 2e 20 54 68 |default |user. Th|
|000048d0| 65 20 64 65 66 61 75 6c | 74 20 75 73 65 72 20 72 |e defaul|t user r|
|000048e0| 65 66 65 72 65 6e 63 65 | 20 6e 75 6d 62 65 72 20 |eference| number |
|000048f0| 69 73 20 6e 6f 72 6d 61 | 6c 6c 79 20 6e 65 76 65 |is norma|lly neve|
|00004900| 72 20 64 65 6c 65 74 65 | 64 20 61 6e 64 20 69 73 |r delete|d and is|
|00004910| 20 76 61 6c 69 64 20 66 | 6f 72 20 63 6f 6e 6e 65 | valid f|or conne|
|00004920| 63 74 69 6f 6e 73 20 74 | 6f 20 74 68 65 20 6f 74 |ctions t|o the ot|
|00004930| 68 65 72 20 4d 61 63 69 | 6e 74 6f 73 68 20 75 6e |her Maci|ntosh un|
|00004940| 74 69 6c 20 6f 6e 65 20 | 6f 66 20 74 68 65 20 61 |til one |of the a|
|00004950| 63 74 69 6f 6e 73 20 69 | 6e 20 23 32 20 61 62 6f |ctions i|n #2 abo|
|00004960| 76 65 20 6f 63 63 75 72 | 73 2e 0d 57 69 74 68 20 |ve occur|s..With |
|00004970| 74 68 61 74 20 6f 75 74 | 20 6f 66 20 74 68 65 20 |that out| of the |
|00004980| 77 61 79 2c 20 68 65 72 | 65 d5 73 20 68 6f 77 20 |way, her|e.s how |
|00004990| 75 73 65 72 20 72 65 66 | 65 72 65 6e 63 65 20 6e |user ref|erence n|
|000049a0| 75 6d 62 65 72 73 20 61 | 72 65 20 75 73 65 64 20 |umbers a|re used |
|000049b0| 77 68 65 6e 20 73 65 6e | 64 69 6e 67 20 68 69 67 |when sen|ding hig|
|000049c0| 68 2d 6c 65 76 65 6c 20 | 65 76 65 6e 74 73 20 61 |h-level |events a|
|000049d0| 6e 64 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 3a |nd Apple| events:|
|000049e0| 20 57 68 65 6e 20 79 6f | 75 20 66 69 72 73 74 20 | When yo|u first |
|000049f0| 73 65 6e 64 20 61 20 68 | 69 67 68 2d 6c 65 76 65 |send a h|igh-leve|
|00004a00| 6c 20 65 76 65 6e 74 20 | 6f 72 20 61 6e 20 41 70 |l event |or an Ap|
|00004a10| 70 6c 65 20 65 76 65 6e | 74 20 74 6f 20 61 6e 6f |ple even|t to ano|
|00004a20| 74 68 65 72 20 4d 61 63 | 69 6e 74 6f 73 68 2c 20 |ther Mac|intosh, |
|00004a30| 74 68 65 20 63 6f 64 65 | 20 74 68 61 74 20 73 74 |the code| that st|
|00004a40| 61 72 74 73 20 74 68 65 | 20 73 65 73 73 69 6f 6e |arts the| session|
|00004a50| 20 77 69 74 68 20 74 68 | 65 20 6f 74 68 65 72 20 | with th|e other |
|00004a60| 73 79 73 74 65 6d 20 64 | 6f 65 73 20 6e 6f 74 20 |system d|oes not |
|00004a70| 61 74 74 65 6d 70 74 20 | 74 6f 20 75 73 65 20 74 |attempt |to use t|
|00004a80| 68 65 20 64 65 66 61 75 | 6c 74 20 75 73 65 72 20 |he defau|lt user |
|00004a90| 72 65 66 65 72 65 6e 63 | 65 20 6e 75 6d 62 65 72 |referenc|e number|
|00004aa0| 2c 20 6f 72 20 61 6e 79 | 20 6f 74 68 65 72 20 75 |, or any| other u|
|00004ab0| 73 65 72 20 72 65 66 65 | 72 65 6e 63 65 20 6e 75 |ser refe|rence nu|
|00004ac0| 6d 62 65 72 20 74 6f 20 | 73 74 61 72 74 20 74 68 |mber to |start th|
|00004ad0| 65 20 73 65 73 73 69 6f | 6e 20 61 6e 64 20 69 74 |e sessio|n and it|
|00004ae0| 20 64 6f 65 73 20 6e 6f | 74 20 6b 65 65 70 20 74 | does no|t keep t|
|00004af0| 68 65 20 75 73 65 72 20 | 72 65 66 65 72 65 6e 63 |he user |referenc|
|00004b00| 65 20 6e 75 6d 62 65 72 | 20 72 65 74 75 72 6e 65 |e number| returne|
|00004b10| 64 20 74 6f 20 69 74 20 | 62 79 20 53 74 61 72 74 |d to it |by Start|
|00004b20| 53 65 63 75 72 65 53 65 | 73 73 69 6f 6e 2e 20 54 |SecureSe|ssion. T|
|00004b30| 68 65 20 73 65 73 73 69 | 6f 6e 20 69 73 20 6b 65 |he sessi|on is ke|
|00004b40| 70 74 20 6f 70 65 6e 20 | 66 6f 72 20 74 68 65 20 |pt open |for the |
|00004b50| 6c 69 66 65 20 6f 66 20 | 74 68 65 20 61 70 70 6c |life of |the appl|
|00004b60| 69 63 61 74 69 6f 6e 2c | 20 6f 72 20 75 6e 74 69 |ication,| or unti|
|00004b70| 6c 20 74 68 65 20 6f 74 | 68 65 72 20 73 69 64 65 |l the ot|her side|
|00004b80| 20 6f 66 20 74 68 65 20 | 73 65 73 73 69 6f 6e 20 | of the |session |
|00004b90| 6f 72 20 61 20 6e 65 74 | 77 6f 72 6b 20 66 61 69 |or a net|work fai|
|00004ba0| 6c 75 72 65 20 62 72 65 | 61 6b 73 20 74 68 65 20 |lure bre|aks the |
|00004bb0| 63 6f 6e 6e 65 63 74 69 | 6f 6e 2e 0d 57 68 65 6e |connecti|on..When|
|00004bc0| 20 79 6f 75 20 73 74 61 | 72 74 65 64 20 79 6f 75 | you sta|rted you|
|00004bd0| 72 20 50 50 43 20 73 65 | 73 73 69 6f 6e 2c 20 53 |r PPC se|ssion, S|
|00004be0| 74 61 72 74 53 65 63 75 | 72 65 53 65 73 73 69 6f |tartSecu|reSessio|
|00004bf0| 6e 20 63 72 65 61 74 65 | 64 20 61 20 75 73 65 72 |n create|d a user|
|00004c00| 20 72 65 66 65 72 65 6e | 63 65 20 6e 75 6d 62 65 | referen|ce numbe|
|00004c10| 72 20 77 68 69 63 68 20 | 63 6f 75 6c 64 20 62 65 |r which |could be|
|00004c20| 20 75 73 65 64 20 74 6f | 20 73 74 61 72 74 20 61 | used to| start a|
|00004c30| 6e 6f 74 68 65 72 20 50 | 50 43 20 73 65 73 73 69 |nother P|PC sessi|
|00004c40| 6f 6e 20 77 69 74 68 6f | 75 74 20 61 75 74 68 65 |on witho|ut authe|
|00004c50| 6e 74 69 63 61 74 69 6f | 6e 2e 20 48 6f 77 65 76 |nticatio|n. Howev|
|00004c60| 65 72 2c 20 74 68 65 20 | 45 76 65 6e 74 20 4d 61 |er, the |Event Ma|
|00004c70| 6e 61 67 65 72 20 6b 6e | 6f 77 73 20 6e 6f 74 68 |nager kn|ows noth|
|00004c80| 69 6e 67 20 6f 66 20 74 | 68 61 74 20 75 73 65 72 |ing of t|hat user|
|00004c90| 20 72 65 66 65 72 65 6e | 63 65 20 6e 75 6d 62 65 | referen|ce numbe|
|00004ca0| 72 2c 20 73 6f 20 77 68 | 65 6e 20 79 6f 75 20 73 |r, so wh|en you s|
|00004cb0| 65 6e 64 20 79 6f 75 72 | 20 66 69 72 73 74 20 41 |end your| first A|
|00004cc0| 70 70 6c 65 20 45 76 65 | 6e 74 2c 20 69 74 20 63 |pple Eve|nt, it c|
|00004cd0| 61 6c 6c 73 20 53 74 61 | 72 74 53 65 63 75 72 65 |alls Sta|rtSecure|
|00004ce0| 53 65 73 73 69 6f 6e 20 | 61 67 61 69 6e 20 74 6f |Session |again to|
|00004cf0| 20 61 75 74 68 65 6e 74 | 69 63 61 74 65 20 74 68 | authent|icate th|
|00004d00| 65 20 6e 65 77 20 73 65 | 73 73 69 6f 6e 2e 20 53 |e new se|ssion. S|
|00004d10| 69 6e 63 65 20 74 68 65 | 72 65 20 69 73 6e d5 74 |ince the|re isn.t|
|00004d20| 20 61 6e 79 20 77 61 79 | 20 66 6f 72 20 79 6f 75 | any way| for you|
|00004d30| 20 74 6f 20 70 61 73 73 | 20 74 68 65 20 75 73 65 | to pass| the use|
|00004d40| 72 20 72 65 66 65 72 65 | 6e 63 65 20 6e 75 6d 62 |r refere|nce numb|
|00004d50| 65 72 20 66 72 6f 6d 20 | 74 68 65 20 50 50 43 20 |er from |the PPC |
|00004d60| 73 65 73 73 69 6f 6e 20 | 74 6f 20 74 68 65 20 45 |session |to the E|
|00004d70| 76 65 6e 74 20 4d 61 6e | 61 67 65 72 20 74 6f 20 |vent Man|ager to |
|00004d80| 73 74 61 72 74 20 69 74 | 73 20 73 65 73 73 69 6f |start it|s sessio|
|00004d90| 6e 2c 20 74 68 65 72 65 | d5 73 20 6e 6f 74 68 69 |n, there|.s nothi|
|00004da0| 6e 67 20 79 6f 75 20 63 | 61 6e 20 64 6f 20 61 62 |ng you c|an do ab|
|00004db0| 6f 75 74 20 74 68 69 73 | 20 62 65 68 61 76 69 6f |out this| behavio|
|00004dc0| 72 2e 0d 53 65 6e 64 69 | 6e 67 20 61 70 70 6c 69 |r..Sendi|ng appli|
|00004dd0| 63 61 74 69 6f 6e 73 20 | 6d 75 73 74 20 62 65 20 |cations |must be |
|00004de0| 68 69 67 68 2d 6c 65 76 | 65 6c 20 65 76 65 6e 74 |high-lev|el event|
|00004df0| 20 61 77 61 72 65 0d 57 | 72 69 74 74 65 6e 3a 09 | aware.W|ritten:.|
|00004e00| 37 2f 33 30 2f 39 32 0d | 4c 61 73 74 20 72 65 76 |7/30/92.|Last rev|
|00004e10| 69 65 77 65 64 3a 09 39 | 2f 31 35 2f 39 32 0d 57 |iewed:.9|/15/92.W|
|00004e20| 68 79 20 64 6f 20 49 20 | 67 65 74 20 65 72 72 6f |hy do I |get erro|
|00004e30| 72 20 2d 39 30 33 20 28 | 61 20 50 50 43 20 54 6f |r -903 (|a PPC To|
|00004e40| 6f 6c 62 6f 78 20 6e 6f | 50 6f 72 74 45 72 72 29 |olbox no|PortErr)|
|00004e50| 20 77 68 65 6e 20 49 20 | 73 65 6e 64 20 61 6e 20 | when I |send an |
|00004e60| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 74 6f 20 61 |Apple ev|ent to a|
|00004e70| 20 72 75 6e 6e 69 6e 67 | 20 61 70 70 6c 69 63 61 | running| applica|
|00004e80| 74 69 6f 6e 20 77 69 74 | 68 20 41 45 53 65 6e 64 |tion wit|h AESend|
|00004e90| 3f 0d 5f 5f 5f 0d 54 68 | 65 20 69 73 48 69 67 68 |?.___.Th|e isHigh|
|00004ea0| 4c 65 76 65 6c 45 76 65 | 6e 74 41 77 61 72 65 20 |LevelEve|ntAware |
|00004eb0| 62 69 74 20 6f 66 20 74 | 68 65 20 73 65 6e 64 69 |bit of t|he sendi|
|00004ec0| 6e 67 20 61 70 70 6c 69 | 63 61 74 69 6f 6e d5 73 |ng appli|cation.s|
|00004ed0| 20 53 49 5a 45 20 2d 31 | 20 72 65 73 6f 75 72 63 | SIZE -1| resourc|
|00004ee0| 65 20 28 61 6e 64 20 53 | 49 5a 45 20 30 20 72 65 |e (and S|IZE 0 re|
|00004ef0| 73 6f 75 72 63 65 2c 20 | 69 66 20 61 6e 79 29 20 |source, |if any) |
|00004f00| 6d 75 73 74 20 62 65 20 | 73 65 74 2e 0d 45 64 69 |must be |set..Edi|
|00004f10| 74 69 6f 6e 20 4d 61 6e | 61 67 65 72 20 51 26 41 |tion Man|ager Q&A|
|00004f20| 73 0d 49 6e 74 65 72 61 | 70 70 6c 69 63 61 74 69 |s.Intera|pplicati|
|00004f30| 6f 6e 20 43 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |on Commu|nication|
|00004f40| 09 4d 2e 49 43 2e 45 64 | 69 74 69 6f 6e 4d 67 72 |.M.IC.Ed|itionMgr|
|00004f50| 2e 51 26 41 73 0d 52 65 | 76 69 73 65 64 20 62 79 |.Q&As.Re|vised by|
|00004f60| 3a 09 44 65 76 65 6c 6f | 70 65 72 20 53 75 70 70 |:.Develo|per Supp|
|00004f70| 6f 72 74 20 43 65 6e 74 | 65 72 09 4f 63 74 6f 62 |ort Cent|er.Octob|
|00004f80| 65 72 20 31 39 39 32 0d | 57 72 69 74 74 65 6e 20 |er 1992.|Written |
|00004f90| 62 79 3a 09 44 65 76 65 | 6c 6f 70 65 72 20 53 75 |by:.Deve|loper Su|
|00004fa0| 70 70 6f 72 74 20 43 65 | 6e 74 65 72 09 4f 63 74 |pport Ce|nter.Oct|
|00004fb0| 6f 62 65 72 20 31 39 39 | 30 0d 54 68 69 73 20 54 |ober 199|0.This T|
|00004fc0| 65 63 68 6e 69 63 61 6c | 20 4e 6f 74 65 20 63 6f |echnical| Note co|
|00004fd0| 6e 74 61 69 6e 73 20 61 | 20 63 6f 6c 6c 65 63 74 |ntains a| collect|
|00004fe0| 69 6f 6e 20 6f 66 20 51 | 26 41 73 20 72 65 6c 61 |ion of Q|&As rela|
|00004ff0| 74 69 6e 67 20 74 6f 20 | 61 20 73 70 65 63 69 66 |ting to |a specif|
|00005000| 69 63 20 74 6f 70 69 63 | d1 71 75 65 73 74 69 6f |ic topic|.questio|
|00005010| 6e 73 20 79 6f 75 d5 76 | 65 20 73 65 6e 74 20 74 |ns you.v|e sent t|
|00005020| 68 65 20 44 65 76 65 6c | 6f 70 65 72 20 53 75 70 |he Devel|oper Sup|
|00005030| 70 6f 72 74 20 43 65 6e | 74 65 72 20 28 44 53 43 |port Cen|ter (DSC|
|00005040| 29 20 61 6c 6f 6e 67 20 | 77 69 74 68 20 61 6e 73 |) along |with ans|
|00005050| 77 65 72 73 20 66 72 6f | 6d 20 74 68 65 20 44 53 |wers fro|m the DS|
|00005060| 43 20 65 6e 67 69 6e 65 | 65 72 73 2e 20 57 68 69 |C engine|ers. Whi|
|00005070| 6c 65 20 44 53 43 20 65 | 6e 67 69 6e 65 65 72 73 |le DSC e|ngineers|
|00005080| 20 68 61 76 65 20 63 68 | 65 63 6b 65 64 20 74 68 | have ch|ecked th|
|00005090| 65 20 51 26 41 20 63 6f | 6e 74 65 6e 74 20 66 6f |e Q&A co|ntent fo|
|000050a0| 72 20 61 63 63 75 72 61 | 63 79 2c 20 74 68 65 20 |r accura|cy, the |
|000050b0| 51 26 41 20 54 65 63 68 | 6e 69 63 61 6c 20 4e 6f |Q&A Tech|nical No|
|000050c0| 74 65 73 20 64 6f 6e d5 | 74 20 68 61 76 65 20 74 |tes don.|t have t|
|000050d0| 68 65 20 65 64 69 74 69 | 6e 67 20 61 6e 64 20 6f |he editi|ng and o|
|000050e0| 72 67 61 6e 69 7a 61 74 | 69 6f 6e 20 6f 66 20 6f |rganizat|ion of o|
|000050f0| 74 68 65 72 20 54 65 63 | 68 6e 69 63 61 6c 20 4e |ther Tec|hnical N|
|00005100| 6f 74 65 73 2e 20 54 68 | 65 20 51 26 41 20 66 75 |otes. Th|e Q&A fu|
|00005110| 6e 63 74 69 6f 6e 20 69 | 73 20 74 6f 20 67 65 74 |nction i|s to get|
|00005120| 20 6e 65 77 20 74 65 63 | 68 6e 69 63 61 6c 20 69 | new tec|hnical i|
|00005130| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 61 6e 64 20 75 |nformati|on and u|
|00005140| 70 64 61 74 65 73 20 74 | 6f 20 79 6f 75 20 71 75 |pdates t|o you qu|
|00005150| 69 63 6b 6c 79 2c 20 73 | 61 76 69 6e 67 20 74 68 |ickly, s|aving th|
|00005160| 65 20 70 6f 6c 69 73 68 | 20 66 6f 72 20 77 68 65 |e polish| for whe|
|00005170| 6e 20 74 68 65 20 69 6e | 66 6f 72 6d 61 74 69 6f |n the in|formatio|
|00005180| 6e 20 6d 69 67 72 61 74 | 65 73 20 69 6e 74 6f 20 |n migrat|es into |
|00005190| 72 65 66 65 72 65 6e 63 | 65 20 6d 61 6e 75 61 6c |referenc|e manual|
|000051a0| 73 2e 0d 51 26 41 73 20 | 61 72 65 20 6e 6f 77 20 |s..Q&As |are now |
|000051b0| 69 6e 63 6c 75 64 65 64 | 20 77 69 74 68 20 54 65 |included| with Te|
|000051c0| 63 68 6e 69 63 61 6c 20 | 4e 6f 74 65 73 20 74 6f |chnical |Notes to|
|000051d0| 20 6d 61 6b 65 20 61 63 | 63 65 73 73 20 74 6f 20 | make ac|cess to |
|000051e0| 74 65 63 68 6e 69 63 61 | 6c 20 75 70 64 61 74 65 |technica|l update|
|000051f0| 73 20 65 61 73 69 65 72 | 20 66 6f 72 20 79 6f 75 |s easier| for you|
|00005200| 2e 20 49 66 20 79 6f 75 | 20 68 61 76 65 20 63 6f |. If you| have co|
|00005210| 6d 6d 65 6e 74 73 20 6f | 72 20 73 75 67 67 65 73 |mments o|r sugges|
|00005220| 74 69 6f 6e 73 20 61 62 | 6f 75 74 20 51 26 41 20 |tions ab|out Q&A |
|00005230| 63 6f 6e 74 65 6e 74 20 | 6f 72 20 64 69 73 74 72 |content |or distr|
|00005240| 69 62 75 74 69 6f 6e 2c | 20 70 6c 65 61 73 65 20 |ibution,| please |
|00005250| 6c 65 74 20 75 73 20 6b | 6e 6f 77 20 62 79 20 73 |let us k|now by s|
|00005260| 65 6e 64 69 6e 67 20 61 | 6e 20 41 70 70 6c 65 4c |ending a|n AppleL|
|00005270| 69 6e 6b 20 74 6f 20 44 | 45 56 46 45 45 44 42 41 |ink to D|EVFEEDBA|
|00005280| 43 4b 2e 20 41 70 70 6c | 65 20 50 61 72 74 6e 65 |CK. Appl|e Partne|
|00005290| 72 73 20 6d 61 79 20 73 | 65 6e 64 20 74 65 63 68 |rs may s|end tech|
|000052a0| 6e 69 63 61 6c 20 71 75 | 65 73 74 69 6f 6e 73 20 |nical qu|estions |
|000052b0| 61 62 6f 75 74 20 51 26 | 41 20 63 6f 6e 74 65 6e |about Q&|A conten|
|000052c0| 74 20 74 6f 20 44 45 56 | 53 55 50 50 4f 52 54 20 |t to DEV|SUPPORT |
|000052d0| 66 6f 72 20 72 65 73 6f | 6c 75 74 69 6f 6e 2e 0d |for reso|lution..|
|000052e0| 4e 65 77 20 51 26 41 73 | 20 61 6e 64 20 51 26 41 |New Q&As| and Q&A|
|000052f0| 73 20 72 65 76 69 73 65 | 64 20 74 68 69 73 20 6d |s revise|d this m|
|00005300| 6f 6e 74 68 20 61 72 65 | 20 6d 61 72 6b 65 64 20 |onth are| marked |
|00005310| 77 69 74 68 20 61 20 62 | 61 72 20 69 6e 20 74 68 |with a b|ar in th|
|00005320| 65 20 73 69 64 65 20 6d | 61 72 67 69 6e 2e 0d 4f |e side m|argin..O|
|00005330| 72 64 65 72 69 6e 67 20 | 6f 66 20 27 66 6d 74 73 |rdering |of 'fmts|
|00005340| 27 20 69 6e 20 61 6e 20 | 65 64 69 74 69 6f 6e 20 |' in an |edition |
|00005350| 63 6f 6e 74 61 69 6e 65 | 72 0d 57 72 69 74 74 65 |containe|r.Writte|
|00005360| 6e 3a 09 36 2f 31 33 2f | 39 31 0d 4c 61 73 74 20 |n:.6/13/|91.Last |
|00005370| 72 65 76 69 65 77 65 64 | 3a 09 38 2f 31 2f 39 32 |reviewed|:.8/1/92|
|00005380| 0d 49 73 20 74 68 65 72 | 65 20 61 6e 79 20 6f 72 |.Is ther|e any or|
|00005390| 64 65 72 69 6e 67 20 74 | 6f 20 74 68 65 20 27 66 |dering t|o the 'f|
|000053a0| 6d 74 73 27 20 65 64 69 | 74 69 6f 6e 20 66 6f 72 |mts' edi|tion for|
|000053b0| 6d 61 74 2c 20 6c 69 6b | 65 20 62 65 73 74 20 74 |mat, lik|e best t|
|000053c0| 6f 20 77 6f 72 73 74 3f | 20 46 6f 72 20 61 70 70 |o worst?| For app|
|000053d0| 6c 69 63 61 74 69 6f 6e | 73 20 74 68 61 74 20 73 |lication|s that s|
|000053e0| 75 70 70 6f 72 74 20 73 | 75 62 73 63 72 69 62 69 |upport s|ubscribi|
|000053f0| 6e 67 20 74 6f 20 61 20 | 6c 61 72 67 65 20 6e 75 |ng to a |large nu|
|00005400| 6d 62 65 72 20 6f 66 20 | 66 6f 72 6d 61 74 73 2c |mber of |formats,|
|00005410| 20 64 65 66 61 75 6c 74 | 69 6e 67 20 74 6f 20 d2 | default|ing to .|
|00005420| 62 65 73 74 d3 20 69 73 | 20 6e 6f 6e 74 72 69 76 |best. is| nontriv|
|00005430| 69 61 6c 2e 0d 5f 5f 5f | 0d 54 68 65 72 65 20 69 |ial..___|.There i|
|00005440| 73 20 6e 6f 20 69 6d 70 | 6c 69 63 69 74 20 6f 72 |s no imp|licit or|
|00005450| 64 65 72 69 6e 67 20 6f | 66 20 74 68 65 20 66 6f |dering o|f the fo|
|00005460| 72 6d 61 74 73 20 69 6e | 20 61 6e 20 65 64 69 74 |rmats in| an edit|
|00005470| 69 6f 6e 20 63 6f 6e 74 | 61 69 6e 65 72 2e 20 54 |ion cont|ainer. T|
|00005480| 68 65 79 20 61 72 65 20 | 77 72 69 74 74 65 6e 20 |hey are |written |
|00005490| 61 6e 64 20 72 65 61 64 | 20 61 6e 64 20 72 65 74 |and read| and ret|
|000054a0| 75 72 6e 65 64 20 69 6e | 20 74 68 65 20 27 66 6d |urned in| the 'fm|
|000054b0| 74 73 27 20 72 65 73 6f | 75 72 63 65 20 69 6e 20 |ts' reso|urce in |
|000054c0| 74 68 65 20 6f 72 64 65 | 72 20 69 6e 20 77 68 69 |the orde|r in whi|
|000054d0| 63 68 20 74 68 65 79 20 | 77 65 72 65 20 77 72 69 |ch they |were wri|
|000054e0| 74 74 65 6e 20 69 6e 74 | 6f 20 74 68 65 20 63 6f |tten int|o the co|
|000054f0| 6e 74 61 69 6e 65 72 2e | 20 54 68 69 73 20 69 73 |ntainer.| This is|
|00005500| 20 6e 6f 74 20 61 6e 20 | 61 72 62 69 74 72 61 72 | not an |arbitrar|
|00005510| 79 20 6d 6f 64 65 6c 2c | 20 69 74 d5 73 20 62 61 |y model,| it.s ba|
|00005520| 73 65 64 20 6f 6e 20 69 | 6e 66 6f 72 6d 61 74 69 |sed on i|nformati|
|00005530| 6f 6e 20 74 68 61 74 20 | 74 68 65 20 45 64 69 74 |on that |the Edit|
|00005540| 69 6f 6e 20 4d 61 6e 61 | 67 65 72 2c 20 61 73 20 |ion Mana|ger, as |
|00005550| 73 79 73 74 65 6d 20 73 | 6f 66 74 77 61 72 65 2c |system s|oftware,|
|00005560| 20 5f 63 61 6e d5 74 5f | 20 6b 6e 6f 77 2e 20 54 | _can.t_| know. T|
|00005570| 68 65 20 64 65 63 69 73 | 69 6f 6e 20 77 6f 75 6c |he decis|ion woul|
|00005580| 64 20 62 65 20 5f 76 65 | 72 79 5f 20 69 6d 70 6c |d be _ve|ry_ impl|
|00005590| 65 6d 65 6e 74 61 74 69 | 6f 6e 20 64 65 70 65 6e |ementati|on depen|
|000055a0| 64 65 6e 74 2e 20 59 6f | 75 72 20 75 73 65 72 73 |dent. Yo|ur users|
|000055b0| 20 6d 61 79 20 70 72 65 | 66 65 72 20 79 6f 75 72 | may pre|fer your|
|000055c0| 20 6f 77 6e 20 63 75 73 | 74 6f 6d 20 65 64 69 74 | own cus|tom edit|
|000055d0| 69 6f 6e 20 74 79 70 65 | 20 6f 76 65 72 20 61 6c |ion type| over al|
|000055e0| 6c 20 6f 74 68 65 72 73 | 2c 20 73 6f 20 74 68 65 |l others|, so the|
|000055f0| 20 77 61 79 20 79 6f 75 | 20 77 6f 75 6c 64 20 77 | way you| would w|
|00005600| 61 6e 74 20 74 68 65 20 | 27 66 6d 74 73 27 20 72 |ant the |'fmts' r|
|00005610| 65 73 6f 75 72 63 65 20 | 74 6f 20 62 65 20 72 65 |esource |to be re|
|00005620| 74 75 72 6e 65 64 20 77 | 6f 75 6c 64 20 62 65 20 |turned w|ould be |
|00005630| 61 20 67 72 65 61 74 20 | 64 65 61 6c 20 64 69 66 |a great |deal dif|
|00005640| 66 65 72 65 6e 74 20 74 | 68 61 6e 20 61 20 73 69 |ferent t|han a si|
|00005650| 6d 70 6c 65 20 77 6f 72 | 64 20 70 72 6f 63 65 73 |mple wor|d proces|
|00005660| 73 6f 72 2c 20 77 68 6f | 20 77 6f 75 6c 64 20 62 |sor, who| would b|
|00005670| 65 20 70 72 65 66 65 72 | 72 69 6e 67 20 54 45 58 |e prefer|ring TEX|
|00005680| 54 2e 0d 53 6f 20 74 68 | 65 20 73 79 73 74 65 6d |T..So th|e system|
|00005690| 20 63 61 6e d5 74 20 6d | 61 6b 65 20 74 68 61 74 | can.t m|ake that|
|000056a0| 20 64 65 63 69 73 69 6f | 6e 2e 20 49 74 20 64 6f | decisio|n. It do|
|000056b0| 65 73 6e d5 74 20 6b 6e | 6f 77 20 77 68 6f 20 69 |esn.t kn|ow who i|
|000056c0| 73 20 63 61 6c 6c 69 6e | 67 20 74 68 65 20 65 64 |s callin|g the ed|
|000056d0| 69 74 69 6f 6e 20 6d 61 | 6e 61 67 65 72 20 61 6e |ition ma|nager an|
|000056e0| 64 20 63 61 6e d5 74 20 | 6b 6e 6f 77 20 77 68 61 |d can.t |know wha|
|000056f0| 74 20 66 6f 72 6d 61 74 | 20 79 6f 75 72 20 73 70 |t format| your sp|
|00005700| 65 63 69 66 69 63 20 61 | 70 70 6c 69 63 61 74 69 |ecific a|pplicati|
|00005710| 6f 6e 20 70 72 65 66 65 | 72 73 2e 20 41 6e 79 20 |on prefe|rs. Any |
|00005720| 6f 72 64 65 72 69 6e 67 | 20 69 74 20 6d 61 79 20 |ordering| it may |
|00005730| 6d 61 6b 65 20 77 6f 75 | 6c 64 20 62 65 20 77 72 |make wou|ld be wr|
|00005740| 6f 6e 67 20 66 6f 72 20 | 61 20 6c 61 72 67 65 20 |ong for |a large |
|00005750| 73 65 74 20 6f 66 20 64 | 65 76 65 6c 6f 70 65 72 |set of d|eveloper|
|00005760| 73 2e 20 53 6f 2c 20 69 | 74 20 72 65 6c 69 65 73 |s. So, i|t relies|
|00005770| 20 6f 6e 20 6a 75 73 74 | 20 67 69 76 69 6e 67 20 | on just| giving |
|00005780| 62 61 63 6b 20 74 68 65 | 20 66 6f 72 6d 61 74 73 |back the| formats|
|00005790| 20 69 6e 20 74 68 65 20 | 6f 72 64 65 72 20 74 68 | in the |order th|
|000057a0| 61 74 20 74 68 65 79 20 | 77 65 72 65 20 77 72 69 |at they |were wri|
|000057b0| 74 74 65 6e 2e 20 4f 66 | 20 63 6f 75 72 73 65 2c |tten. Of| course,|
|000057c0| 20 69 66 20 79 6f 75 20 | 61 72 65 20 63 75 73 74 | if you |are cust|
|000057d0| 6f 6d 69 7a 69 6e 67 20 | 79 6f 75 72 20 53 75 62 |omizing |your Sub|
|000057e0| 73 63 72 69 62 65 72 20 | 64 69 61 6c 6f 67 20 77 |scriber |dialog w|
|000057f0| 69 74 68 20 79 6f 75 72 | 20 6f 77 6e 20 70 6f 70 |ith your| own pop|
|00005800| 75 70 2c 20 41 70 70 6c | 65 20 72 65 63 6f 6d 6d |up, Appl|e recomm|
|00005810| 65 6e 64 73 20 74 68 61 | 74 20 79 6f 75 20 6f 72 |ends tha|t you or|
|00005820| 64 65 72 20 74 68 65 20 | 70 6f 70 75 70 20 28 6f |der the |popup (o|
|00005830| 72 20 6c 69 73 74 2c 20 | 6f 72 20 77 68 61 74 65 |r list, |or whate|
|00005840| 76 65 72 29 20 74 6f 20 | 73 75 69 74 20 74 68 65 |ver) to |suit the|
|00005850| 20 6e 65 65 64 73 20 6f | 66 20 79 6f 75 72 20 61 | needs o|f your a|
|00005860| 70 70 6c 69 63 61 74 69 | 6f 6e 20 62 65 73 74 2c |pplicati|on best,|
|00005870| 20 64 65 66 61 75 6c 74 | 69 6e 67 20 74 6f 20 79 | default|ing to y|
|00005880| 6f 75 72 20 d2 62 65 73 | 74 d3 20 66 6f 72 6d 61 |our .bes|t. forma|
|00005890| 74 3b 20 68 6f 77 65 76 | 65 72 2c 20 74 68 65 72 |t; howev|er, ther|
|000058a0| 65 20 69 73 20 6e 6f 20 | 77 61 79 20 74 6f 20 65 |e is no |way to e|
|000058b0| 6e 66 6f 72 63 65 20 74 | 68 69 73 2e 20 54 68 65 |nforce t|his. The|
|000058c0| 20 65 6e 68 61 6e 63 65 | 64 20 73 75 62 73 63 72 | enhance|d subscr|
|000058d0| 69 62 65 72 20 64 69 61 | 6c 6f 67 73 20 64 65 73 |iber dia|logs des|
|000058e0| 69 67 6e 20 69 73 2f 61 | 72 65 20 75 70 20 74 6f |ign is/a|re up to|
|000058f0| 20 69 6e 64 69 76 69 64 | 75 61 6c 20 64 65 76 65 | individ|ual deve|
|00005900| 6c 6f 70 65 72 73 2e 0d | 53 65 74 45 64 69 74 69 |lopers..|SetEditi|
|00005910| 6f 6e 46 6f 72 6d 61 74 | 4d 61 72 6b d5 73 20 73 |onFormat|Mark.s s|
|00005920| 65 74 4d 61 72 6b 54 6f | 20 70 61 72 61 6d 65 74 |etMarkTo| paramet|
|00005930| 65 72 0d 57 72 69 74 74 | 65 6e 3a 09 37 2f 32 39 |er.Writt|en:.7/29|
|00005940| 2f 39 31 0d 4c 61 73 74 | 20 72 65 76 69 65 77 65 |/91.Last| reviewe|
|00005950| 64 3a 09 38 2f 31 2f 39 | 32 0d 48 6f 77 20 69 73 |d:.8/1/9|2.How is|
|00005960| 20 53 65 74 45 64 69 74 | 69 6f 6e 46 6f 72 6d 61 | SetEdit|ionForma|
|00005970| 74 4d 61 72 6b d5 73 20 | 74 68 69 72 64 20 70 61 |tMark.s |third pa|
|00005980| 72 61 6d 65 74 65 72 20 | 28 73 65 74 4d 61 72 6b |rameter |(setMark|
|00005990| 54 6f 29 20 74 6f 20 62 | 65 20 64 65 74 65 72 6d |To) to b|e determ|
|000059a0| 69 6e 65 64 3f 20 49 73 | 20 69 74 20 61 6c 77 61 |ined? Is| it alwa|
|000059b0| 79 73 20 7a 65 72 6f 20 | 66 6f 72 20 74 68 65 20 |ys zero |for the |
|000059c0| 73 74 61 72 74 20 6f 66 | 20 65 61 63 68 20 66 6f |start of| each fo|
|000059d0| 72 6d 61 74 3f 20 44 6f | 65 73 20 69 74 20 6d 65 |rmat? Do|es it me|
|000059e0| 61 6e 20 74 68 61 74 20 | 61 6e 79 20 63 68 75 6e |an that |any chun|
|000059f0| 6b 20 6f 66 20 74 68 65 | 20 65 64 69 74 69 6f 6e |k of the| edition|
|00005a00| 20 63 61 6e 20 62 65 20 | 6f 62 74 61 69 6e 65 64 | can be |obtained|
|00005a10| 2c 20 75 73 69 6e 67 20 | 74 68 65 20 73 74 61 72 |, using |the star|
|00005a20| 74 69 6e 67 20 6d 61 72 | 6b 20 61 6e 64 20 62 79 |ting mar|k and by|
|00005a30| 74 65 20 63 6f 75 6e 74 | 2c 20 65 78 61 63 74 6c |te count|, exactl|
|00005a40| 79 20 6c 69 6b 65 20 72 | 65 61 64 69 6e 67 20 61 |y like r|eading a|
|00005a50| 20 66 69 6c 65 3f 0d 5f | 5f 5f 0d 54 68 65 20 73 | file?._|__.The s|
|00005a60| 65 74 4d 61 72 6b 54 6f | 20 70 61 72 61 6d 65 74 |etMarkTo| paramet|
|00005a70| 65 72 20 69 73 20 73 65 | 74 20 6f 6e 6c 79 20 66 |er is se|t only f|
|00005a80| 6f 72 20 74 68 65 20 73 | 70 65 63 69 66 69 63 20 |or the s|pecific |
|00005a90| 66 6f 72 6d 61 74 20 79 | 6f 75 d5 72 65 20 63 6f |format y|ou.re co|
|00005aa0| 6e 63 65 72 6e 65 64 20 | 77 69 74 68 2e 20 53 6f |ncerned |with. So|
|00005ab0| 20 79 65 73 2c 20 69 74 | 20 69 73 20 61 6c 77 61 | yes, it| is alwa|
|00005ac0| 79 73 20 69 6e 69 74 69 | 61 6c 6c 79 20 7a 65 72 |ys initi|ally zer|
|00005ad0| 6f 20 66 6f 72 20 61 6e | 79 20 73 70 65 63 69 66 |o for an|y specif|
|00005ae0| 69 63 20 66 6f 72 6d 61 | 74 20 69 6e 20 61 6e 20 |ic forma|t in an |
|00005af0| 65 64 69 74 69 6f 6e 20 | 63 6f 6e 74 61 69 6e 65 |edition |containe|
|00005b00| 72 20 66 69 6c 65 2e 20 | 41 6e 64 20 79 6f 75 20 |r file. |And you |
|00005b10| 63 61 6e 20 73 65 74 20 | 69 74 20 74 6f 20 77 68 |can set |it to wh|
|00005b20| 61 74 65 76 65 72 20 79 | 6f 75 20 6c 69 6b 65 20 |atever y|ou like |
|00005b30| 66 6f 72 20 74 68 61 74 | 20 70 61 72 74 69 63 75 |for that| particu|
|00005b40| 6c 61 72 20 66 6f 72 6d | 61 74 2e 20 59 6f 75 20 |lar form|at. You |
|00005b50| 63 61 6e 20 67 65 74 20 | 74 68 65 20 6c 65 6e 67 |can get |the leng|
|00005b60| 74 68 20 6f 66 20 74 68 | 65 20 66 6f 72 6d 61 74 |th of th|e format|
|00005b70| 20 79 6f 75 d5 72 65 20 | 63 6f 6e 63 65 72 6e 65 | you.re |concerne|
|00005b80| 64 20 77 69 74 68 20 62 | 79 20 63 61 6c 6c 69 6e |d with b|y callin|
|00005b90| 67 0d 20 20 20 20 45 64 | 69 74 69 6f 6e 48 61 73 |g. Ed|itionHas|
|00005ba0| 46 6f 72 6d 61 74 28 72 | 65 66 4e 75 6d 2c 66 6f |Format(r|efNum,fo|
|00005bb0| 72 6d 61 74 44 65 73 69 | 72 65 64 2c 26 72 65 74 |rmatDesi|red,&ret|
|00005bc0| 75 72 6e 65 64 53 69 7a | 65 29 3b 0d 61 6e 64 20 |urnedSiz|e);.and |
|00005bd0| 72 65 74 75 72 6e 65 64 | 53 69 7a 65 20 77 69 6c |returned|Size wil|
|00005be0| 6c 20 63 6f 6e 74 61 69 | 6e 20 74 68 65 20 73 69 |l contai|n the si|
|00005bf0| 7a 65 20 6f 66 20 74 68 | 61 74 20 66 6f 72 6d 61 |ze of th|at forma|
|00005c00| 74 2e 20 53 6f 20 69 6e | 20 0d 53 65 74 45 64 69 |t. So in| .SetEdi|
|00005c10| 74 69 6f 6e 46 4f 72 6d | 61 74 4d 61 72 6b 20 79 |tionFOrm|atMark y|
|00005c20| 6f 75 72 20 72 61 6e 67 | 65 20 69 73 20 30 2d 72 |our rang|e is 0-r|
|00005c30| 65 74 75 72 6e 65 64 53 | 69 7a 65 2e 0d 54 68 65 |eturnedS|ize..The|
|00005c40| 20 61 6e 73 77 65 72 20 | 74 6f 20 79 6f 75 72 20 | answer |to your |
|00005c50| 74 68 69 72 64 20 71 75 | 65 73 74 69 6f 6e 20 69 |third qu|estion i|
|00005c60| 73 20 d2 6b 69 6e 64 61 | 2e d3 20 59 6f 75 20 63 |s .kinda|.. You c|
|00005c70| 61 6e 20 61 6c 6d 6f 73 | 74 20 74 68 69 6e 6b 20 |an almos|t think |
|00005c80| 6f 66 20 74 68 65 20 73 | 65 70 61 72 61 74 65 20 |of the s|eparate |
|00005c90| 65 64 69 74 69 6f 6e 73 | 20 69 6e 20 61 20 65 64 |editions| in a ed|
|00005ca0| 69 74 69 6f 6e 20 63 6f | 6e 74 61 69 6e 65 72 20 |ition co|ntainer |
|00005cb0| 66 69 6c 65 20 61 73 20 | 61 63 63 65 73 73 69 62 |file as |accessib|
|00005cc0| 6c 65 20 74 68 65 20 73 | 61 6d 65 20 77 61 79 20 |le the s|ame way |
|00005cd0| 61 20 6e 6f 72 6d 61 6c | 20 64 61 74 61 20 66 6f |a normal| data fo|
|00005ce0| 72 6b 20 69 73 2c 20 62 | 75 74 20 79 6f 75 20 68 |rk is, b|ut you h|
|00005cf0| 61 76 65 20 74 6f 20 72 | 65 6d 65 6d 62 65 72 20 |ave to r|emember |
|00005d00| 74 68 61 74 20 79 6f 75 | 20 6d 75 73 74 20 77 6f |that you| must wo|
|00005d10| 72 6b 20 77 69 74 68 20 | 74 68 65 20 45 64 69 74 |rk with |the Edit|
|00005d20| 69 6f 6e 20 4d 61 6e 61 | 67 65 72 20 63 61 6c 6c |ion Mana|ger call|
|00005d30| 73 20 74 6f 20 6d 61 6b | 65 20 73 75 72 65 20 74 |s to mak|e sure t|
|00005d40| 68 69 73 20 77 6f 72 6b | 73 2e 0d 54 68 65 20 65 |his work|s..The e|
|00005d50| 64 69 74 69 6f 6e 20 63 | 6f 6e 74 61 69 6e 65 72 |dition c|ontainer|
|00005d60| 20 66 6f 72 6d 61 74 20 | 6d 61 72 6b 20 66 6f 72 | format |mark for|
|00005d70| 20 61 20 66 6f 72 6d 61 | 74 20 64 6f 65 73 20 4e | a forma|t does N|
|00005d80| 4f 54 20 72 65 6c 61 74 | 65 20 61 74 20 61 6c 6c |OT relat|e at all|
|00005d90| 20 74 6f 20 74 68 65 20 | 61 63 74 75 61 6c 20 6d | to the |actual m|
|00005da0| 61 72 6b 20 74 68 65 20 | 46 69 6c 65 20 4d 61 6e |ark the |File Man|
|00005db0| 61 67 65 72 20 69 73 20 | 75 73 69 6e 67 20 69 6e |ager is |using in|
|00005dc0| 20 74 68 65 20 64 61 74 | 61 20 66 6f 72 6b 2e 20 | the dat|a fork. |
|00005dd0| 54 68 65 20 45 64 69 74 | 69 6f 6e 20 4d 61 6e 61 |The Edit|ion Mana|
|00005de0| 67 65 72 20 64 6f 65 73 | 20 69 74 73 20 6f 77 6e |ger does| its own|
|00005df0| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 20 66 72 6f | transla|tion fro|
|00005e00| 6d 20 45 64 69 74 69 6f | 6e 20 4d 61 6e 61 67 65 |m Editio|n Manage|
|00005e10| 72 20 6d 61 72 6b 20 74 | 6f 20 6c 6f 67 69 63 61 |r mark t|o logica|
|00005e20| 6c 20 66 69 6c 65 20 6d | 61 72 6b 20 77 68 65 6e |l file m|ark when|
|00005e30| 20 79 6f 75 20 6d 61 6b | 65 20 61 20 52 65 61 64 | you mak|e a Read|
|00005e40| 45 64 69 74 69 6f 6e 20 | 63 61 6c 6c 2e 20 53 6f |Edition |call. So|
|00005e50| 2c 20 79 6f 75 20 61 72 | 65 20 6e 65 76 65 72 20 |, you ar|e never |
|00005e60| 69 6e 66 6f 72 6d 65 64 | 20 6f 66 20 77 68 65 72 |informed| of wher|
|00005e70| 65 20 74 68 65 20 61 63 | 74 75 61 6c 20 64 61 74 |e the ac|tual dat|
|00005e80| 61 20 72 65 73 69 64 65 | 73 20 69 6e 20 74 68 65 |a reside|s in the|
|00005e90| 20 45 43 46 2e 0d 54 68 | 69 73 20 69 73 20 6e 65 | ECF..Th|is is ne|
|00005ea0| 63 65 73 73 61 72 79 20 | 74 6f 20 61 6c 6c 6f 77 |cessary |to allow|
|00005eb0| 20 74 68 65 20 45 64 69 | 74 69 6f 6e 20 4d 61 6e | the Edi|tion Man|
|00005ec0| 61 67 65 72 20 72 6f 6f | 6d 20 74 6f 20 65 78 70 |ager roo|m to exp|
|00005ed0| 61 6e 64 2e 20 42 79 20 | 68 61 76 69 6e 67 20 74 |and. By |having t|
|00005ee0| 68 65 20 45 64 69 74 69 | 6f 6e 20 4d 61 6e 61 67 |he Editi|on Manag|
|00005ef0| 65 72 20 6d 61 6b 65 20 | 74 68 65 20 63 6f 6e 76 |er make |the conv|
|00005f00| 65 72 73 69 6f 6e 73 2c | 20 79 6f 75 20 61 63 68 |ersions,| you ach|
|00005f10| 69 65 76 65 20 74 77 6f | 20 74 68 69 6e 67 73 3a |ieve two| things:|
|00005f20| 0d 31 29 20 54 68 65 20 | 68 65 61 64 65 72 20 69 |.1) The |header i|
|00005f30| 6e 20 74 68 65 20 45 43 | 46 20 63 61 6e 20 62 65 |n the EC|F can be|
|00005f40| 20 6d 6f 64 69 66 69 65 | 64 2c 20 65 78 74 65 6e | modifie|d, exten|
|00005f50| 64 65 64 20 6f 72 20 73 | 68 6f 72 74 65 6e 65 64 |ded or s|hortened|
|00005f60| 20 61 6e 79 74 69 6d 65 | 2c 20 61 6e 64 20 6e 6f | anytime|, and no|
|00005f70| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 61 72 | applica|tions ar|
|00005f80| 65 20 64 65 70 65 6e 64 | 65 6e 74 20 6f 6e 20 74 |e depend|ent on t|
|00005f90| 68 65 20 d2 72 65 61 6c | d3 20 66 69 6c 65 20 6d |he .real|. file m|
|00005fa0| 61 72 6b 2e 0d 32 29 20 | 59 6f 75 20 61 73 20 61 |ark..2) |You as a|
|00005fb0| 6e 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 64 6f |n applic|ation do|
|00005fc0| 6e d5 74 20 68 61 76 65 | 20 74 6f 20 77 6f 72 72 |n.t have| to worr|
|00005fd0| 79 20 61 62 6f 75 74 20 | 61 6e 6f 74 68 65 72 20 |y about |another |
|00005fe0| 66 6f 72 6d 61 74 20 62 | 65 69 6e 67 20 61 64 64 |format b|eing add|
|00005ff0| 65 64 20 74 6f 20 74 68 | 65 20 45 43 46 20 77 68 |ed to th|e ECF wh|
|00006000| 69 6c 65 20 79 6f 75 20 | 61 72 65 20 72 65 61 64 |ile you |are read|
|00006010| 69 6e 67 20 61 6e 6f 74 | 68 65 72 20 6f 6e 65 2e |ing anot|her one.|
|00006020| 20 53 61 79 20 74 68 65 | 20 45 44 46 20 63 75 72 | Say the| EDF cur|
|00006030| 72 65 6e 74 6c 79 20 68 | 61 73 20 74 77 6f 20 66 |rently h|as two f|
|00006040| 6f 72 6d 61 74 73 2c 20 | 61 20 31 4b 20 50 49 43 |ormats, |a 1K PIC|
|00006050| 54 20 61 74 20 74 68 65 | 20 62 65 67 69 6e 6e 69 |T at the| beginni|
|00006060| 6e 67 20 6f 66 20 74 68 | 65 20 66 69 6c 65 2c 20 |ng of th|e file, |
|00006070| 61 6e 64 20 61 20 32 4b | 20 54 45 58 54 20 61 66 |and a 2K| TEXT af|
|00006080| 74 65 72 20 69 74 2e 20 | 59 6f 75 20 61 72 65 20 |ter it. |You are |
|00006090| 72 65 61 64 69 6e 67 20 | 74 68 65 20 54 45 58 54 |reading |the TEXT|
|000060a0| 20 35 30 20 62 79 74 65 | 73 20 61 74 20 61 20 74 | 50 byte|s at a t|
|000060b0| 69 6d 65 20 28 66 6f 72 | 20 73 6f 6d 65 20 72 65 |ime (for| some re|
|000060c0| 61 73 6f 6e 20 6f 72 20 | 6f 74 68 65 72 29 2e 20 |ason or |other). |
|000060d0| 57 68 69 6c 65 20 79 6f | 75 20 61 72 65 20 64 6f |While yo|u are do|
|000060e0| 69 6e 67 20 74 68 61 74 | 2c 20 74 68 65 20 70 75 |ing that|, the pu|
|000060f0| 62 6c 69 73 68 65 72 20 | 75 70 64 61 74 65 73 20 |blisher |updates |
|00006100| 74 68 65 20 27 50 49 43 | 54 27 2e 20 54 68 65 20 |the 'PIC|T'. The |
|00006110| 54 45 58 54 20 69 73 20 | 68 65 6c 64 20 69 6e 20 |TEXT is |held in |
|00006120| 61 20 62 75 66 66 65 72 | 2c 20 62 65 63 61 75 73 |a buffer|, becaus|
|00006130| 65 20 74 68 65 20 45 4d | 20 6b 6e 6f 77 73 20 74 |e the EM| knows t|
|00006140| 68 61 74 20 73 6f 6d 65 | 6f 6e 65 20 69 73 20 72 |hat some|one is r|
|00006150| 65 61 64 69 6e 67 20 69 | 74 2e 20 42 75 74 20 74 |eading i|t. But t|
|00006160| 68 65 20 50 49 43 54 20 | 63 61 6e 20 62 65 20 77 |he PICT |can be w|
|00006170| 72 69 74 74 65 6e 20 6e | 6f 77 2c 20 65 76 65 6e |ritten n|ow, even|
|00006180| 20 69 66 20 69 74 73 20 | 73 69 7a 65 20 63 68 61 | if its |size cha|
|00006190| 6e 67 65 73 2c 20 61 6e | 64 20 74 68 65 20 45 64 |nges, an|d the Ed|
|000061a0| 69 74 69 6f 6e 20 4d 61 | 6e 61 67 65 72 20 6a 75 |ition Ma|nager ju|
|000061b0| 73 74 20 63 68 61 6e 67 | 65 73 20 69 74 73 20 6f |st chang|es its o|
|000061c0| 66 66 73 65 74 20 74 6f | 20 74 68 65 20 6d 61 72 |ffset to| the mar|
|000061d0| 6b 20 66 6f 72 20 74 68 | 65 20 54 45 58 54 2e 20 |k for th|e TEXT. |
|000061e0| 59 6f 75 20 61 73 20 74 | 68 65 20 61 70 70 6c 69 |You as t|he appli|
|000061f0| 63 61 74 69 6f 6e 20 73 | 74 69 6c 6c 20 63 6f 6e |cation s|till con|
|00006200| 74 69 6e 75 65 20 74 6f | 20 75 73 65 20 74 68 65 |tinue to| use the|
|00006210| 20 73 61 6d 65 20 6d 61 | 72 6b 3b 20 74 68 65 20 | same ma|rk; the |
|00006220| 73 69 7a 65 20 6f 66 20 | 74 68 65 20 66 69 6c 65 |size of |the file|
|00006230| 20 63 68 61 6e 67 65 64 | 20 62 75 74 20 79 6f 75 | changed| but you|
|00006240| 20 64 69 64 20 6e 6f 74 | 20 68 61 76 65 20 74 6f | did not| have to|
|00006250| 20 62 65 20 61 77 61 72 | 65 20 6f 66 20 69 74 2e | be awar|e of it.|
|00006260| 0d 53 6f 20 79 6f 75 20 | 63 61 6e 20 6d 61 6e 61 |.So you |can mana|
|00006270| 67 65 20 72 65 61 64 69 | 6e 67 20 66 6f 72 6d 61 |ge readi|ng forma|
|00006280| 74 73 20 79 6f 75 72 73 | 65 6c 66 2c 20 79 6f 75 |ts yours|elf, you|
|00006290| 20 63 61 6e 20 d2 62 61 | 74 63 68 d3 20 69 6e 20 | can .ba|tch. in |
|000062a0| 61 20 6c 61 72 67 65 20 | 66 6f 72 6d 61 74 20 28 |a large |format (|
|000062b0| 6f 72 20 77 72 69 74 65 | 20 69 74 20 6f 75 74 20 |or write| it out |
|000062c0| 69 6e 20 63 68 75 6e 6b | 73 29 20 62 75 74 20 79 |in chunk|s) but y|
|000062d0| 6f 75 20 68 61 76 65 20 | 74 6f 20 75 73 65 20 45 |ou have |to use E|
|000062e0| 64 69 74 69 6f 6e 20 4d | 61 6e 61 67 65 72 20 72 |dition M|anager r|
|000062f0| 65 61 64 20 61 6e 64 20 | 77 72 69 74 65 20 63 61 |ead and |write ca|
|00006300| 6c 6c 73 20 74 6f 20 64 | 6f 20 69 74 2c 20 6e 6f |lls to d|o it, no|
|00006310| 74 20 46 69 6c 65 20 4d | 61 6e 61 67 65 72 20 63 |t File M|anager c|
|00006320| 61 6c 6c 73 2e 0d 41 70 | 70 6c 65 20 27 63 6e 63 |alls..Ap|ple 'cnc|
|00006330| 6c 27 20 73 65 63 74 69 | 6f 6e 20 63 61 6e 63 65 |l' secti|on cance|
|00006340| 6c 20 65 76 65 6e 74 0d | 57 72 69 74 74 65 6e 3a |l event.|Written:|
|00006350| 09 38 2f 32 33 2f 39 31 | 0d 4c 61 73 74 20 72 65 |.8/23/91|.Last re|
|00006360| 76 69 65 77 65 64 3a 09 | 38 2f 31 2f 39 32 0d 57 |viewed:.|8/1/92.W|
|00006370| 68 65 6e 20 77 69 6c 6c | 20 74 68 65 20 d2 73 65 |hen will| the .se|
|00006380| 63 74 69 6f 6e 20 63 61 | 6e 63 65 6c d3 20 41 70 |ction ca|ncel. Ap|
|00006390| 70 6c 65 20 65 76 65 6e | 74 20 62 65 20 69 6d 70 |ple even|t be imp|
|000063a0| 6c 65 6d 65 6e 74 65 64 | 20 69 6e 20 74 68 65 20 |lemented| in the |
|000063b0| 66 75 74 75 72 65 20 73 | 6f 20 74 68 65 20 73 79 |future s|o the sy|
|000063c0| 73 74 65 6d 20 63 61 6e | 20 73 65 6e 64 20 69 74 |stem can| send it|
|000063d0| 3f 20 49 d5 76 65 20 69 | 6d 70 6c 65 6d 65 6e 74 |? I.ve i|mplement|
|000063e0| 65 64 20 69 74 2c 20 62 | 75 74 20 62 65 63 61 75 |ed it, b|ut becau|
|000063f0| 73 65 20 69 74 d5 73 20 | 68 61 72 64 20 74 6f 20 |se it.s |hard to |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.